@voltro/cli 0.50.0 → 0.51.0

package/dist/{build-CnSH-zru.js → build-DETLZAFt.js}

@@ -1,21 +1,21 @@
-import { gn as e } from "./dev-1yu42ubu.js";
-import { $ as t, A as n, F as r, I as i, L as a, Q as o, a as s, b as c, d as l, et as u, f as d, ht as f, k as p, rt as m, s as h, v as g, vt as _, y as v } from "./webDev-B4IEMB0n.js";
-import { t as y } from "./cliRuntime-Dh7UDinH.js";
-import { a as b } from "./renderModeScan-D7J1B7Kw.js";
-import { i as x, o as S, s as C } from "./apiBuild-CFYXo06U.js";
-import { n as w } from "./renderProfile-1OWWAAtx.js";
-import { dirname as T, join as E, resolve as D } from "node:path";
-import { existsSync as O, promises as k } from "node:fs";
+import { gn as e } from "./dev-kdAg9Q7l.js";
+import { $ as t, A as n, I as r, L as i, R as a, a as o, b as s, d as c, et as l, f as u, gt as d, it as f, j as p, k as m, s as h, tt as g, v as _, y as v, yt as y } from "./webDev-B-ubQEMX.js";
+import { t as b } from "./cliRuntime-Dh7UDinH.js";
+import { a as x } from "./renderModeScan-D7J1B7Kw.js";
+import { i as S, o as C, s as w } from "./apiBuild-CPDHXF72.js";
+import { n as T } from "./renderProfile-1OWWAAtx.js";
+import { dirname as E, join as D, resolve as O } from "node:path";
+import { existsSync as k, promises as A } from "node:fs";
 import "node:url";
-import { createLogger as A } from "@voltro/logger";
-import { Effect as j } from "effect";
-import { createRequire as M } from "node:module";
+import { createLogger as j } from "@voltro/logger";
+import { Effect as M } from "effect";
+import { createRequire as N } from "node:module";
 //#region src/webStartBundle.ts
-var N = A({ scope: "voltro:build" }), P = async (e) => {
-	let t = await _("esbuild", () => import("esbuild")), n = E(e, ".framework"), r = E(n, "dist-web", "startBundle");
-	await k.mkdir(n, { recursive: !0 });
-	let i = Date.now(), a = E(e, "tsconfig.json"), o = /* @__PURE__ */ new Set(), s = E(n, "startEntry.ts");
-	await k.writeFile(s, [
+var P = j({ scope: "voltro:build" }), F = async (e) => {
+	let t = await y("esbuild", () => import("esbuild")), n = D(e, ".framework"), r = D(n, "dist-web", "startBundle");
+	await A.mkdir(n, { recursive: !0 });
+	let i = Date.now(), a = D(e, "tsconfig.json"), o = /* @__PURE__ */ new Set(), s = D(n, "startEntry.ts");
+	await A.writeFile(s, [
 		"// GENERATED BY `voltro build` — do not edit; overwritten on next build.",
 		"import { runStartCommand as __run, loadDotEnv } from '@voltro/cli/startEntry'",
 		"import { pathToFileURL, fileURLToPath } from 'node:url'",
@@ -47,35 +47,35 @@ var N = A({ scope: "voltro:build" }), P = async (e) => {
 		outdir: r,
 		splitting: !0,
 		write: !0,
-		plugins: [S([], e, o)],
+		plugins: [C([], e, o)],
 		banner: { js: "import { createRequire as __voltroRequire } from 'node:module'; const require = __voltroRequire(import.meta.url);" },
 		jsx: "automatic",
 		jsxImportSource: "react",
 		logLevel: "silent",
 		absWorkingDir: e,
-		alias: x("startEntry"),
-		...O(a) ? { tsconfig: a } : {}
+		alias: S("startEntry"),
+		...k(a) ? { tsconfig: a } : {}
 	});
-	let c = await C(r, i);
-	return N.info("web build: start bundle written", {
-		out: E(".framework", "dist-web", "startBundle", "startEntry.js"),
+	let c = await w(r, i);
+	return P.info("web build: start bundle written", {
+		out: D(".framework", "dist-web", "startBundle", "startEntry.js"),
 		...o.size > 0 ? { externalizedOptionalPeers: [...o].join(", ") } : {},
 		...c > 0 ? { prunedStaleChunks: c } : {}
-	}), E(r, "startEntry.js");
-}, F = A({ scope: "voltro:build" }), I = (e, t) => ({
+	}), D(r, "startEntry.js");
+}, I = j({ scope: "voltro:build" }), L = (e, t) => ({
 	name: "voltro:ssr-optional-peer-external",
 	enforce: "pre",
 	resolveId(n, r) {
 		if (n.startsWith(".") || n.startsWith("/") || n.startsWith("\0") || n.startsWith("node:") || n === "effect" || n.startsWith("@effect/") || n.startsWith("@voltro/")) return null;
-		for (let t of [r ? T(r) : void 0, e]) if (t !== void 0) try {
-			return M(E(t, "_.js")).resolve(n), null;
+		for (let t of [r ? E(r) : void 0, e]) if (t !== void 0) try {
+			return N(D(t, "_.js")).resolve(n), null;
 		} catch {}
 		return t.add(n), {
 			id: n,
 			external: !0
 		};
 	}
-}), L = (e) => /\[/.test(e), R = (e, t) => {
+}), R = (e) => /\[/.test(e), z = (e, t) => {
 	let n = e.split("/").filter(Boolean), r = [];
 	for (let i of n) if (i.startsWith("[[...") && i.endsWith("]]")) {
 		let e = t[i.slice(5, -2)];
@@ -91,48 +91,48 @@ var N = A({ scope: "voltro:build" }), P = async (e) => {
 		r.push(a);
 	} else r.push(i);
 	return r.length === 0 ? "/" : "/" + r.join("/");
-}, z = (e, t) => {
-	if (t === "/" || t === "") return E(e, "index.html");
+}, B = (e, t) => {
+	if (t === "/" || t === "") return D(e, "index.html");
 	let n = t.replace(/^\//, "").split("/");
-	return E(e, ...n, "index.html");
-}, B = (e) => e.replace(/<script\b(?=[^>]*\btype="module")(?:(?!<\/script>).)*<\/script>/gi, "").replace(/<script\b(?=[^>]*\bsrc=)(?:(?!<\/script>).)*<\/script>/gi, "").replace(/<link\b[^>]*\brel="modulepreload"[^>]*>/gi, ""), V = (e, t) => {
+	return D(e, ...n, "index.html");
+}, V = (e) => e.replace(/<script\b(?=[^>]*\btype="module")(?:(?!<\/script>).)*<\/script>/gi, "").replace(/<script\b(?=[^>]*\bsrc=)(?:(?!<\/script>).)*<\/script>/gi, "").replace(/<link\b[^>]*\brel="modulepreload"[^>]*>/gi, ""), H = (e, t) => {
 	let r = e.replace("<div id=\"root\"></div>", `<div id="root">${t.body}</div>`), i = [
 		t.metaHtml,
 		`<meta name="voltro-interactive" content="${t.interactive}" />`,
 		t.stateScript
 	].filter((e) => e.length > 0).join("\n    ");
-	return r = n(r, i), t.interactive === "none" && (r = B(r)), r;
-}, H = async (e) => {
-	let { page: t, chainEntries: o, pageMod: c, helpers: l } = e, u = o.filter((e) => e.hasLayout);
-	if (u.length === 0) return F.debug("skip page", {
+	return r = n(p(r, i), t.documentAttrs), t.interactive === "none" && (r = V(r)), r;
+}, U = async (e) => {
+	let { page: t, chainEntries: n, pageMod: s, helpers: c } = e, l = n.filter((e) => e.hasLayout);
+	if (l.length === 0) return I.debug("skip page", {
 		pattern: t.pattern,
 		reason: "renderMode=spa with no layout — nothing to shell"
 	}), null;
-	if (L(t.pattern)) return F.debug("skip page", {
+	if (R(t.pattern)) return I.debug("skip page", {
 		pattern: t.pattern,
 		reason: "renderMode=spa with a dynamic pattern"
 	}), null;
-	let d = await Promise.all(u.map(e.loadLayout)), f = u.filter((e, t) => typeof d[t]?.loader == "function").map((e) => e.dir || "/");
-	if (f.length > 0) return F.info(`spa shell for ${t.pattern} left to on-demand rendering — its layout chain has a loader (${f.join(", ")}), whose output may be per-request`, {
+	let u = await Promise.all(l.map(e.loadLayout)), d = l.filter((e, t) => typeof u[t]?.loader == "function").map((e) => e.dir || "/");
+	if (d.length > 0) return I.info(`spa shell for ${t.pattern} left to on-demand rendering — its layout chain has a loader (${d.join(", ")}), whose output may be per-request`, {
 		pattern: t.pattern,
-		layouts: f
+		layouts: d
 	}), null;
-	let { chain: p, segmentLoaderData: m } = await s({
-		entries: o,
+	let { chain: f, segmentLoaderData: m } = await o({
+		entries: n,
 		loadLayout: e.loadLayout,
 		loadError: e.loadError,
 		loadPending: e.loadPending,
 		ctx: e.ctx
 	}), h = {
 		pattern: t.pattern,
-		Component: c.default,
-		meta: c.meta,
-		ErrorBoundary: c.ErrorBoundary,
-		Pending: c.Pending,
+		Component: s.default,
+		meta: s.meta,
+		ErrorBoundary: s.ErrorBoundary,
+		Pending: s.Pending,
 		renderMode: "spa",
-		chain: p
-	}, g = c.interactive ?? "full", _ = r({
-		helpers: l,
+		chain: f
+	}, g = s.interactive ?? "full", _ = r({
+		helpers: c,
 		page: t.pattern,
 		interactive: g,
 		delivery: "artefact",
@@ -145,44 +145,44 @@ var N = A({ scope: "voltro:build" }), P = async (e) => {
 			...e.locale ? { locale: e.locale } : {}
 		}
 	}), v = i({
-		helpers: l,
+		helpers: c,
 		prepared: _
 	}), y = a({
-		helpers: l,
+		helpers: c,
 		prepared: _,
 		meta: v.meta,
 		interactive: g
-	}), b = n(e.shellTemplate.replace("<div id=\"root\"></div>", `<div id="root">${v.body}</div>`), y), x = z(e.distDir, t.pattern);
-	return await k.mkdir(T(x), { recursive: !0 }), await k.writeFile(x, b, "utf8"), F.debug("prerendered spa layout shell", { pattern: t.pattern }), {
+	}), b = p(e.shellTemplate.replace("<div id=\"root\"></div>", `<div id="root">${v.body}</div>`), y), x = B(e.distDir, t.pattern);
+	return await A.mkdir(E(x), { recursive: !0 }), await A.writeFile(x, b, "utf8"), I.debug("prerendered spa layout shell", { pattern: t.pattern }), {
 		pattern: t.pattern,
 		outPath: x
 	};
-}, U = async (e) => {
-	let { root: t, distDir: n, pages: r, dirs: i, vite: a } = e, o = E(n, "index.html"), c = await k.readFile(o, "utf8"), l = E(n, "_voltro", "shell.html");
-	await k.mkdir(T(l), { recursive: !0 }), await k.writeFile(l, c, "utf8");
-	let u = E(t, "node_modules", "@voltro", "ui-shadcn"), d = O(E(u, "package.json")) ? u : null, f = [...d ? [
+}, W = async (e) => {
+	let { root: t, distDir: n, pages: r, dirs: i, vite: a } = e, s = D(n, "index.html"), c = await A.readFile(s, "utf8"), l = D(n, "_voltro", "shell.html");
+	await A.mkdir(E(l), { recursive: !0 }), await A.writeFile(l, c, "utf8");
+	let u = D(t, "node_modules", "@voltro", "ui-shadcn"), d = k(D(u, "package.json")) ? u : null, p = [...d ? [
 		{
 			find: "@voltro/ui-shadcn/tokens.css",
-			replacement: E(d, "src/tokens.css")
+			replacement: D(d, "src/tokens.css")
 		},
 		{
 			find: "@voltro/ui-shadcn/cn",
-			replacement: E(d, "src/cn.ts")
+			replacement: D(d, "src/cn.ts")
 		},
 		{
 			find: "@voltro/ui-shadcn/brand",
-			replacement: E(d, "src/brand/voltroLogo.tsx")
+			replacement: D(d, "src/brand/voltroLogo.tsx")
 		},
 		{
 			find: "@voltro/ui-shadcn",
-			replacement: E(d, "src/index.ts")
+			replacement: D(d, "src/index.ts")
 		}
-	] : [], ...m(t)], g = await a.createServer({
-		root: E(t, ".framework"),
+	] : [], ...f(t)], g = await a.createServer({
+		root: D(t, ".framework"),
 		envPrefix: "__VOLTRO_VITE_ENV_DISABLED__",
 		plugins: [(await import("@vitejs/plugin-react")).default(), (await import("@tailwindcss/vite")).default()],
 		resolve: {
-			alias: f,
+			alias: p,
 			dedupe: [
 				"react",
 				"react-dom",
@@ -198,20 +198,27 @@ var N = A({ scope: "voltro:build" }), P = async (e) => {
 		},
 		appType: "custom",
 		logLevel: "warn"
-	}), _ = await g.ssrLoadModule("@voltro/web/ssr"), { renderPageToHtml: v, renderMetaToHtml: y, renderRouterStateScript: x, isDeferredLoaderResult: S, assertDeferralSupported: C, beginStoreSeeds: w, seedPreloadedSubscription: D, seedPreloadedSubscriptionFailure: A } = _, j = /* @__PURE__ */ new Map();
+	}), _ = await g.ssrLoadModule("@voltro/web/ssr"), { renderPageToHtml: v, renderMetaToHtml: y, renderRouterStateScript: b, isDeferredLoaderResult: S, assertDeferralSupported: C, beginStoreSeeds: w, seedPreloadedSubscription: T, seedPreloadedSubscriptionFailure: O } = _, j, M = /* @__PURE__ */ new Map();
 	if (e.locales && e.locales.length > 0 && e.defaultLocale) try {
-		let n = (await g.ssrLoadModule("@voltro/i18n")).makeSsgWrap;
-		if (typeof n != "function") throw Error("@voltro/i18n is installed but missing the `makeSsgWrap` export — upgrade @voltro/i18n to a version that ships SSG support.");
-		for (let r of e.locales) try {
-			let i = await g.ssrLoadModule(E(t, "src", "locales", `${r}.ts`)), a = i.default ?? i;
-			j.set(r, n(r, a, e.defaultLocale));
+		let n = await g.ssrLoadModule("@voltro/i18n");
+		try {
+			j = (await g.ssrLoadModule("@voltro/i18n/server")).resolveTimeZone?.({
+				configured: e.timeZone ?? null,
+				defaultTimeZone: e.defaultTimeZone ?? null
+			});
+		} catch {}
+		let r = n.makeSsgWrap;
+		if (typeof r != "function") throw Error("@voltro/i18n is installed but missing the `makeSsgWrap` export — upgrade @voltro/i18n to a version that ships SSG support.");
+		for (let n of e.locales) try {
+			let i = await g.ssrLoadModule(D(t, "src", "locales", `${n}.ts`)), a = i.default ?? i;
+			M.set(n, r(n, a, e.defaultLocale));
 		} catch (e) {
-			F.warn(`i18n catalog missing for locale '${r}' — pages rendered at /${r}/* will crash. Add src/locales/${r}.ts.`, {}, e);
+			I.warn(`i18n catalog missing for locale '${n}' — pages rendered at /${n}/* will crash. Add src/locales/${n}.ts.`, {}, e);
 		}
 	} catch (e) {
-		F.warn("i18n wrapper unavailable for SSG — pages that call useT() will fail. Check that @voltro/i18n is installed.", {}, e);
+		I.warn("i18n wrapper unavailable for SSG — pages that call useT() will fail. Check that @voltro/i18n is installed.", {}, e);
 	}
-	let M = [], N = {}, P = (e) => e.dir === "" ? E(t, "src", "pages") : E(t, "src", "pages", e.dir), I = async (e) => await g.ssrLoadModule(E(P(e), "layout.tsx")), B = async (e) => await g.ssrLoadModule(E(P(e), "error.tsx")), U = async (e) => await g.ssrLoadModule(E(P(e), "loading.tsx")), W = (e, t) => ({
+	let N = [], P = {}, F = (e) => e.dir === "" ? D(t, "src", "pages") : D(t, "src", "pages", e.dir), L = async (e) => await g.ssrLoadModule(D(F(e), "layout.tsx")), V = async (e) => await g.ssrLoadModule(D(F(e), "error.tsx")), W = async (e) => await g.ssrLoadModule(D(F(e), "loading.tsx")), G = (e, t) => ({
 		params: e.params,
 		pathname: e.pathname,
 		search: "",
@@ -221,62 +228,62 @@ var N = A({ scope: "voltro:build" }), P = async (e) => {
 		isServer: !0
 	});
 	for (let a of r) {
-		let r = `${E(t, "src", "pages", a.file)}`, o = await g.ssrLoadModule(r), l = b(o, E("src", "pages", a.file));
-		N[a.pattern] = l;
+		let r = `${D(t, "src", "pages", a.file)}`, s = await g.ssrLoadModule(r), l = x(s, D("src", "pages", a.file));
+		P[a.pattern] = l;
 		let u = l.renderMode, d = h(i, a.dirChain);
 		if (u === "spa") {
-			let t = await H({
+			let t = await U({
 				page: a,
 				chainEntries: d,
-				pageMod: o,
+				pageMod: s,
 				shellTemplate: c,
 				distDir: n,
 				helpers: _,
-				loadLayout: I,
-				loadError: B,
-				loadPending: U,
-				ctx: W({
+				loadLayout: L,
+				loadError: V,
+				loadPending: W,
+				ctx: G({
 					params: {},
 					pathname: a.pattern
 				}, new AbortController().signal),
-				outerWrap: j.get(e.defaultLocale ?? ""),
+				outerWrap: M.get(e.defaultLocale ?? ""),
 				locale: e.defaultLocale
 			});
-			t && M.push(t);
+			t && N.push(t);
 			continue;
 		}
 		if (u !== "static") {
-			F.debug("skip page", {
+			I.debug("skip page", {
 				pattern: a.pattern,
 				reason: `renderMode=${u}`
 			});
 			continue;
 		}
 		let f;
-		if (L(a.pattern)) {
-			if (typeof o.getStaticPaths != "function") {
-				F.debug("skip page", {
+		if (R(a.pattern)) {
+			if (typeof s.getStaticPaths != "function") {
+				I.debug("skip page", {
 					pattern: a.pattern,
 					reason: "no getStaticPaths export"
 				});
 				continue;
 			}
 			try {
-				let e = await o.getStaticPaths();
+				let e = await s.getStaticPaths();
 				if (!Array.isArray(e)) {
-					F.warn("skip page — getStaticPaths did not return an array", { pattern: a.pattern });
+					I.warn("skip page — getStaticPaths did not return an array", { pattern: a.pattern });
 					continue;
 				}
 				f = e.map((e) => ({
 					params: e.params,
-					pathname: R(a.pattern, e.params)
+					pathname: z(a.pattern, e.params)
 				}));
 			} catch (e) {
-				F.warn("skip page — getStaticPaths threw", { pattern: a.pattern }, e);
+				I.warn("skip page — getStaticPaths threw", { pattern: a.pattern }, e);
 				continue;
 			}
 			if (f.length === 0) {
-				F.debug("skip page", {
+				I.debug("skip page", {
 					pattern: a.pattern,
 					reason: "getStaticPaths returned []"
 				});
@@ -286,47 +293,47 @@ var N = A({ scope: "voltro:build" }), P = async (e) => {
 			params: {},
 			pathname: a.pattern
 		}];
-		let m = o.interactive ?? "full";
+		let p = s.interactive ?? "full";
 		for (let t of f) {
 			w();
 			let r, i, l = new AbortController();
 			try {
-				({chain: r, segmentLoaderData: i} = await s({
+				({chain: r, segmentLoaderData: i} = await o({
 					entries: d,
-					loadLayout: I,
-					loadError: B,
-					loadPending: U,
-					ctx: W(t, l.signal)
+					loadLayout: L,
+					loadError: V,
+					loadPending: W,
+					ctx: G(t, l.signal)
 				}));
 			} catch (e) {
 				let n = e?._voltroControl;
 				if (e instanceof Error && n === "redirect") throw Error(`Static page "${t.pathname}" threw RedirectError from a LAYOUT loader at build time. Static pages can't redirect per-request — switch it to renderMode 'ssr'.`);
 				if (e instanceof Error && n === "not-found") {
-					F.warn("layout loader threw NotFoundError at build time — skipping artifact", { pathname: t.pathname });
+					I.warn("layout loader threw NotFoundError at build time — skipping artifact", { pathname: t.pathname });
 					continue;
 				}
-				F.warn("layout loader threw, falling back to no layout data", { pathname: t.pathname }, e), {chain: r, segmentLoaderData: i} = await s({
+				I.warn("layout loader threw, falling back to no layout data", { pathname: t.pathname }, e), {chain: r, segmentLoaderData: i} = await o({
 					entries: d,
-					loadLayout: async (e) => ({ default: (await I(e)).default }),
-					loadError: B,
-					loadPending: U,
-					ctx: W(t, l.signal)
+					loadLayout: async (e) => ({ default: (await L(e)).default }),
+					loadError: V,
+					loadPending: W,
+					ctx: G(t, l.signal)
 				});
 			}
 			let f = {
 				pattern: a.pattern,
-				Component: o.default,
-				meta: o.meta,
-				loader: o.loader,
-				ErrorBoundary: o.ErrorBoundary,
-				Pending: o.Pending,
+				Component: s.default,
+				meta: s.meta,
+				loader: s.loader,
+				ErrorBoundary: s.ErrorBoundary,
+				Pending: s.Pending,
 				renderMode: u,
 				chain: r
 			}, h = null;
-			if (typeof o.loader == "function") {
+			if (typeof s.loader == "function") {
 				let e = new AbortController();
 				try {
-					h = await o.loader({
+					h = await s.loader({
 						params: t.params,
 						pathname: t.pathname,
 						search: "",
@@ -338,91 +345,105 @@ var N = A({ scope: "voltro:build" }), P = async (e) => {
 				} catch (e) {
 					if (e instanceof Error && e._voltroControl === "redirect") throw Error(`Static page "${t.pathname}" threw RedirectError at build time. Static pages can't redirect per-request — switch it to renderMode 'ssr'.`);
 					if (e instanceof Error && e._voltroControl === "not-found") {
-						F.warn("loader threw NotFoundError at build time — skipping artifact", { pathname: t.pathname });
+						I.warn("loader threw NotFoundError at build time — skipping artifact", { pathname: t.pathname });
 						continue;
 					}
-					F.warn("loader threw, falling back to null", { pathname: t.pathname }, e);
+					I.warn("loader threw, falling back to null", { pathname: t.pathname }, e);
 				}
 			}
 			S(h) && C({
 				page: t.pathname,
 				renderMode: u,
-				interactive: m
+				interactive: p
 			});
 			for (let e of Object.values(i)) S(e) && C({
 				page: t.pathname,
 				renderMode: u,
-				interactive: m
+				interactive: p
 			});
-			await p({
-				pageMod: o,
+			await m({
+				pageMod: s,
 				params: t.params,
 				query: void 0,
 				apiName: void 0,
-				seed: D,
-				seedFailure: A
+				seed: T,
+				seedFailure: O
 			});
-			let g = t.params.locale ?? e.defaultLocale ?? "en", _ = j.get(g) ?? j.get(e.defaultLocale ?? ""), { html: b, meta: E } = v({
+			let g = t.params.locale ?? e.defaultLocale ?? "en", _ = M.get(g) ?? M.get(e.defaultLocale ?? ""), x = Date.now(), D = _ ? (e) => _(e, {
+				timeZone: j,
+				renderedAt: x
+			}) : void 0, { html: k, meta: P } = v({
 				descriptor: f,
 				params: t.params,
 				pathname: t.pathname,
 				loaderData: h,
 				segmentLoaderData: i,
-				..._ ? { outerWrap: _ } : {},
+				...D ? { outerWrap: D } : {},
 				locale: g
-			}), O = V(c, {
-				body: b,
-				metaHtml: y(E),
-				stateScript: x({
+			}), F = H(c, {
+				body: k,
+				metaHtml: y(P),
+				stateScript: b({
 					path: t.pathname,
 					loaderData: h,
 					segmentLoaderData: i,
-					pageLoaderRan: typeof o.loader == "function"
+					pageLoaderRan: typeof s.loader == "function"
 				}),
-				interactive: m
-			}), N = z(n, t.pathname);
-			await k.mkdir(T(N), { recursive: !0 }), await k.writeFile(N, O, "utf8"), M.push({
+				interactive: p,
+				documentAttrs: {
+					lang: g,
+					...j === void 0 ? {} : { timeZone: j },
+					renderedAt: x
+				}
+			}), R = B(n, t.pathname);
+			await A.mkdir(E(R), { recursive: !0 }), await A.writeFile(R, F, "utf8"), N.push({
 				pattern: t.pathname,
-				outPath: N,
-				...E?.noIndex ? { noIndex: !0 } : {}
+				outPath: R,
+				...P?.noIndex ? { noIndex: !0 } : {}
 			});
 		}
 	}
 	return await g.close(), {
-		rendered: M,
-		pageMeta: N
+		rendered: N,
+		pageMeta: P
 	};
-}, W = async (e, t, n, r, i, a) => {
-	let o = E(e, ".framework"), s = [];
-	for (let e of t) s.push(`  ${JSON.stringify(e.pattern)}: () => import('../src/pages/${e.file}'),`);
-	let c = [], l = [], u = [];
+}, G = async (e, t, n, r, i, a, o) => {
+	let s = D(e, ".framework"), c = [];
+	for (let e of t) c.push(`  ${JSON.stringify(e.pattern)}: () => import('../src/pages/${e.file}'),`);
+	let l = [], u = [], d = [];
 	for (let e of n) {
 		let t = e.dir === "" ? "../src/pages" : `../src/pages/${e.dir}`, n = e.dir === "" ? "/" : e.dir;
-		e.hasLayout && c.push(`  ${JSON.stringify(n)}: () => import('${t}/layout.tsx'),`), e.hasError && l.push(`  ${JSON.stringify(n)}: () => import('${t}/error.tsx'),`), e.hasPending && u.push(`  ${JSON.stringify(n)}: () => import('${t}/loading.tsx'),`);
+		e.hasLayout && l.push(`  ${JSON.stringify(n)}: () => import('${t}/layout.tsx'),`), e.hasError && u.push(`  ${JSON.stringify(n)}: () => import('${t}/error.tsx'),`), e.hasPending && d.push(`  ${JSON.stringify(n)}: () => import('${t}/loading.tsx'),`);
 	}
-	let d = [], f = [];
+	let f = [], p = [];
 	if (r && r.length > 0 && i) for (let t of r) {
-		if (!O(E(e, "src", "locales", `${t}.ts`))) continue;
+		if (!k(D(e, "src", "locales", `${t}.ts`))) continue;
 		let n = `__i18nCat_${t.replace(/[^a-zA-Z0-9]/g, "_")}`;
-		d.push(`import ${n} from '../src/locales/${t}'`), f.push(`  ${JSON.stringify(t)}: makeSsgWrap(${JSON.stringify(t)}, ${n} as unknown as Record<string, string>, ${JSON.stringify(i)}),`);
+		f.push(`import ${n} from '../src/locales/${t}'`), p.push(`  ${JSON.stringify(t)}: makeSsgWrap(${JSON.stringify(t)}, ${n} as unknown as Record<string, string>, ${JSON.stringify(i)}),`);
 	}
-	let p = f.length > 0, m = !p && r !== void 0 && r.length > 0 && i !== void 0, h = p ? [
+	let m = p.length > 0, h = !m && r !== void 0 && r.length > 0 && i !== void 0, g = m ? [
 		"import { makeSsgWrap } from '@voltro/i18n'",
 		"import { makeSsrI18nResolver } from '@voltro/i18n/server'",
-		...d
-	] : m ? ["import { resolveLocale } from '@voltro/i18n/server'"] : [], g = p ? [
+		...f
+	] : h ? ["import { resolveLocale, resolveTimeZone } from '@voltro/i18n/server'"] : [], _ = m ? [
 		"",
 		`const __I18N_SUPPORTED = ${JSON.stringify(r)} as ReadonlyArray<string>`,
 		`const __I18N_DEFAULT = ${JSON.stringify(i)}`,
-		"const __i18nWraps: Record<string, (children: unknown) => unknown> = {",
-		...f,
+		"const __i18nWraps: Record<string, (children: unknown, request?: { timeZone?: string | undefined; renderedAt?: number | undefined }) => unknown> = {",
+		...p,
 		"}",
 		"// Cookie voltro:locale > Accept-Language > default → the matching wrapper.",
 		"// The SAME resolver `voltro dev` calls (webDev.ts) — this used to be a",
 		"// hand-written copy here and NOTHING at all in dev, which is why a",
 		"// localized page rendered under `voltro start` and threw under `voltro dev`.",
-		"const __resolveI18n = makeSsrI18nResolver({ wraps: __i18nWraps, supported: __I18N_SUPPORTED, defaultLocale: __I18N_DEFAULT })"
-	] : m ? [
+		"const __resolveI18n = makeSsrI18nResolver({",
+		"  wraps: __i18nWraps,",
+		"  supported: __I18N_SUPPORTED,",
+		"  defaultLocale: __I18N_DEFAULT,",
+		`  timeZone: ${JSON.stringify(o?.timeZone ?? null)},`,
+		`  defaultTimeZone: ${JSON.stringify(o?.defaultTimeZone ?? null)},`,
+		"})"
+	] : h ? [
 		"",
 		`const __I18N_SUPPORTED = ${JSON.stringify(r)} as ReadonlyArray<string>`,
 		`const __I18N_DEFAULT = ${JSON.stringify(i)}`,
@@ -437,67 +458,72 @@ var N = A({ scope: "voltro:build" }), P = async (e) => {
 		"    supported: __I18N_SUPPORTED,",
 		"    defaultLocale: __I18N_DEFAULT,",
 		"  }),",
+		"  timeZone: resolveTimeZone({",
+		"    cookieHeader: cookieHeader ?? null,",
+		`    configured: ${JSON.stringify(o?.timeZone ?? null)},`,
+		`    defaultTimeZone: ${JSON.stringify(o?.defaultTimeZone ?? null)},`,
+		"  }),",
 		"  outerWrap: (children: unknown) => children,",
 		"})"
-	] : [], _ = "renderPageToHtml, renderPageToStream, renderMetaToHtml, renderRouterStateScript, renderDeferredRegistryScript, prepareDeferredLoaderData, assertDeferralSupported, parseCookieHeader, withStoreSeeds, beginStoreSeeds", v = p || m ? `export const helpers = { ${_}, i18n: { resolve: __resolveI18n } }` : `export const helpers = { ${_} }`, y = [
+	] : [], v = "renderPageToHtml, renderPageToStream, renderMetaToHtml, renderRouterStateScript, renderDeferredRegistryScript, prepareDeferredLoaderData, assertDeferralSupported, parseCookieHeader, withStoreSeeds, beginStoreSeeds", y = m || h ? `export const helpers = { ${v}, i18n: { resolve: __resolveI18n } }` : `export const helpers = { ${v} }`, b = [
 		"// GENERATED BY `voltro build` — do not edit; will be overwritten on next build.",
 		"// Entry for the pre-built SSR bundle. Imported by `voltro start`'s",
 		"// production runtime; bypasses Vite middleware-mode SSR loading.",
 		"",
 		"import { renderPageToHtml, renderPageToStream, renderMetaToHtml, renderRouterStateScript, renderDeferredRegistryScript, prepareDeferredLoaderData, assertDeferralSupported, parseCookieHeader, withStoreSeeds, beginStoreSeeds } from '@voltro/web/ssr'",
-		...h,
+		...g,
 		"",
 		"// Lazy page loaders — a page's module (and content) loads only when its",
 		"// route is rendered, so importing this entry never pulls every page into memory.",
 		"export const pages: Record<string, () => Promise<unknown>> = {",
-		...s,
+		...c,
 		"}",
 		"// Build-time per-route metadata — `voltro start` reads this instead of",
 		"// importing every page module at boot just to inspect its render mode.",
 		`export const pageMeta: Record<string, unknown> = ${JSON.stringify(a ?? {}, null, 2)}`,
 		"export const layouts: Record<string, () => Promise<unknown>> = {",
-		...c,
+		...l,
 		"}",
 		"export const errors: Record<string, () => Promise<unknown>> = {",
-		...l,
+		...u,
 		"}",
 		"export const pendings: Record<string, () => Promise<unknown>> = {",
-		...u,
+		...d,
 		"}",
-		...g,
+		..._,
 		"",
-		v,
+		y,
 		""
-	].join("\n"), b = E(o, "ssrEntry.ts");
-	return await k.writeFile(b, y, "utf8"), b;
-}, G = async (e) => {
+	].join("\n"), x = D(s, "ssrEntry.ts");
+	return await A.writeFile(x, b, "utf8"), x;
+}, K = async (e) => {
 	let { checkRpcGroupFreshness: t } = await import("./codegen-DiMn2KkZ.js"), n = await t(e);
 	if (n.kind === "fresh") return;
-	n.kind === "stale" && F.info("rpcGroup.generated.ts is stale — regenerating", {
+	n.kind === "stale" && I.info("rpcGroup.generated.ts is stale — regenerating", {
 		file: n.file,
 		reason: n.reason
 	});
-	let { regenerateRpcGroup: r } = await import("./codegenCommand-BJzaRz6q.js"), i = await r(e);
+	let { regenerateRpcGroup: r } = await import("./codegenCommand-BNBHcNNj.js"), i = await r(e);
 	if (i.kind === "refused") {
-		F.warn("could not regenerate the rpc group — building against what is on disk", { reason: i.reason });
+		I.warn("could not regenerate the rpc group — building against what is on disk", { reason: i.reason });
 		return;
 	}
-	i.kind === "wrote" && n.kind === "stale" && F.info("rpc group regenerated", {
+	i.kind === "wrote" && n.kind === "stale" && I.info("rpc group regenerated", {
 		plugins: i.plugins,
 		routes: i.routes
 	});
-}, K = async (e) => {
-	let n = await l(e);
+}, q = async (e) => {
+	let n = await c(e);
 	if (!n) {
-		let { loadApiConfig: t } = await import("./dev-BWwE0QjK.js"), n = await t(e);
+		let { loadApiConfig: t } = await import("./dev-CK522MV5.js"), n = await t(e);
 		if (n) {
-			F.info("building api app", { app: n.name ?? "(unnamed)" }), await G(e);
-			let { runApiBuild: t, runServeBundleBuild: r } = await import("./apiBuild-BWo8KI6n.js");
+			I.info("building api app", { app: n.name ?? "(unnamed)" }), await K(e);
+			let { runApiBuild: t, runServeBundleBuild: r } = await import("./apiBuild-GDKuGOMV.js");
 			await t(e);
 			try {
 				await r(e);
 			} catch (e) {
-				return F.fatal("serve bundle build FAILED — refusing to ship a bundle-less image. Fix the error above (production serves from the bundle, never tsx).", {}, e), {
+				return I.fatal("serve bundle build FAILED — refusing to ship a bundle-less image. Fix the error above (production serves from the bundle, never tsx).", {}, e), {
 					ran: !0,
 					exitCode: 1
 				};
@@ -512,45 +538,45 @@ var N = A({ scope: "voltro:build" }), P = async (e) => {
 			exitCode: 0
 		};
 	}
-	F.info("building web app", { app: n.name ?? "(unnamed)" });
-	let { resolved: r } = await f({
+	I.info("building web app", { app: n.name ?? "(unnamed)" });
+	let { resolved: r } = await d({
 		rawEnv: n.env,
 		appType: "web",
 		root: e,
-		log: F,
+		log: I,
 		generateTypes: !0
-	}), i = await d(e, n);
-	await c(e, n, i, r.publicValues);
-	let { pages: a } = await v(E(e, "src", "pages"));
-	await u({
+	}), i = await u(e, n);
+	await s(e, n, i, r.publicValues);
+	let { pages: a } = await v(D(e, "src", "pages"));
+	await g({
 		appRoot: e,
 		pages: a,
 		mode: "prod"
 	});
-	let s = E(e, ".framework"), p = E(s, "dist"), h = E(e, "node_modules", "@voltro", "ui-shadcn"), y = O(E(h, "package.json")) ? h : null, b = [...y ? [
+	let o = D(e, ".framework"), p = D(o, "dist"), m = D(e, "node_modules", "@voltro", "ui-shadcn"), h = k(D(m, "package.json")) ? m : null, b = [...h ? [
 		{
 			find: "@voltro/ui-shadcn/tokens.css",
-			replacement: E(y, "src/tokens.css")
+			replacement: D(h, "src/tokens.css")
 		},
 		{
 			find: "@voltro/ui-shadcn/cn",
-			replacement: E(y, "src/cn.ts")
+			replacement: D(h, "src/cn.ts")
 		},
 		{
 			find: "@voltro/ui-shadcn/brand",
-			replacement: E(y, "src/brand/voltroLogo.tsx")
+			replacement: D(h, "src/brand/voltroLogo.tsx")
 		},
 		{
 			find: "@voltro/ui-shadcn",
-			replacement: E(y, "src/index.ts")
+			replacement: D(h, "src/index.ts")
 		}
-	] : [], ...m(e)];
-	F.info("running vite build");
-	let x = await _("vite", () => import("vite")), C = (await import("@vitejs/plugin-react")).default, T = (await import("@tailwindcss/vite")).default;
+	] : [], ...f(e)];
+	I.info("running vite build");
+	let x = await y("vite", () => import("vite")), S = (await import("@vitejs/plugin-react")).default, w = (await import("@tailwindcss/vite")).default;
 	await x.build({
-		root: s,
+		root: o,
 		envPrefix: "__VOLTRO_VITE_ENV_DISABLED__",
-		plugins: [C(), T()],
+		plugins: [S(), w()],
 		resolve: {
 			alias: b,
 			dedupe: [
@@ -560,41 +586,46 @@ var N = A({ scope: "voltro:build" }), P = async (e) => {
 				"@voltro/i18n"
 			]
 		},
-		publicDir: E(e, "public"),
+		publicDir: D(e, "public"),
 		build: {
 			outDir: "dist",
 			emptyOutDir: !0,
-			rollupOptions: { output: { manualChunks: g } }
+			rollupOptions: { output: { manualChunks: _ } }
 		},
 		logLevel: "warn"
 	});
-	let D = E(e, "src", "pages"), { pages: A, dirs: j } = await v(D);
-	if (A.length === 0) return F.info("no pages found — client-only bundle written", {
-		pagesDir: D,
+	let E = D(e, "src", "pages"), { pages: O, dirs: j } = await v(E);
+	if (O.length === 0) return I.info("no pages found — client-only bundle written", {
+		pagesDir: E,
 		distDir: p
 	}), {
 		ran: !0,
 		exitCode: 0
 	};
-	let { rendered: M, pageMeta: N } = await U({
+	let { rendered: M, pageMeta: N } = await W({
 		root: e,
 		distDir: p,
-		pages: A,
+		pages: O,
 		dirs: j,
 		vite: x,
 		...n.locales ? { locales: n.locales } : {},
-		...n.defaultLocale ? { defaultLocale: n.defaultLocale } : {}
+		...n.defaultLocale ? { defaultLocale: n.defaultLocale } : {},
+		...n.timeZone ? { timeZone: n.timeZone } : {},
+		...n.defaultTimeZone ? { defaultTimeZone: n.defaultTimeZone } : {}
 	});
-	F.info("generating .framework/ssrEntry.ts"), await W(e, A, j, n.locales, n.defaultLocale, N), F.info("vite build --ssr → dist/server/");
-	let L = /* @__PURE__ */ new Set();
+	I.info("generating .framework/ssrEntry.ts"), await G(e, O, j, n.locales, n.defaultLocale, N, {
+		...n.timeZone ? { timeZone: n.timeZone } : {},
+		...n.defaultTimeZone ? { defaultTimeZone: n.defaultTimeZone } : {}
+	}), I.info("vite build --ssr → dist/server/");
+	let P = /* @__PURE__ */ new Set();
 	try {
 		await x.build({
-			root: s,
+			root: o,
 			envPrefix: "__VOLTRO_VITE_ENV_DISABLED__",
 			plugins: [
-				C(),
-				T(),
-				I(e, L)
+				S(),
+				w(),
+				L(e, P)
 			],
 			resolve: {
 				alias: b,
@@ -613,109 +644,109 @@ var N = A({ scope: "voltro:build" }), P = async (e) => {
 				rollupOptions: { output: { format: "esm" } }
 			},
 			logLevel: "warn"
-		}), F.info("SSR bundle ready", {
+		}), I.info("SSR bundle ready", {
 			path: "dist/server/ssrEntry.js",
-			...L.size > 0 ? { externalizedOptionalPeers: [...L].join(", ") } : {}
+			...P.size > 0 ? { externalizedOptionalPeers: [...P].join(", ") } : {}
 		});
 	} catch (e) {
-		return F.fatal("SSR bundle build FAILED — refusing to ship a bundle-less image. Fix the error above (production renders from the SSR bundle, never by compiling on demand).", {}, e), {
+		return I.fatal("SSR bundle build FAILED — refusing to ship a bundle-less image. Fix the error above (production renders from the SSR bundle, never by compiling on demand).", {}, e), {
 			ran: !0,
 			exitCode: 1
 		};
 	}
-	let R = E(e, "app.config.ts");
-	if (O(R)) {
-		F.info("precompiling app.config.ts → dist/server/appConfig.js");
+	let R = D(e, "app.config.ts");
+	if (k(R)) {
+		I.info("precompiling app.config.ts → dist/server/appConfig.js");
 		try {
-			await (await _("esbuild", () => import("esbuild"))).build({
+			await (await y("esbuild", () => import("esbuild"))).build({
 				entryPoints: [R],
-				outfile: E(p, "server", "appConfig.js"),
+				outfile: D(p, "server", "appConfig.js"),
 				bundle: !0,
 				format: "esm",
 				platform: "node",
 				target: "node22",
-				plugins: [S([], e, /* @__PURE__ */ new Set())],
+				plugins: [C([], e, /* @__PURE__ */ new Set())],
 				banner: { js: "import { createRequire as __voltroRequire } from 'node:module'; const require = __voltroRequire(import.meta.url);" },
 				jsx: "automatic",
 				jsxImportSource: "react",
 				absWorkingDir: e,
 				logLevel: "silent",
-				...O(E(e, "tsconfig.json")) ? { tsconfig: E(e, "tsconfig.json") } : {}
+				...k(D(e, "tsconfig.json")) ? { tsconfig: D(e, "tsconfig.json") } : {}
 			});
 		} catch (e) {
-			return F.fatal("app.config precompile FAILED — production `voltro start` would need the tsx loader to read it.", {}, e), {
+			return I.fatal("app.config precompile FAILED — production `voltro start` would need the tsx loader to read it.", {}, e), {
 				ran: !0,
 				exitCode: 1
 			};
 		}
 	}
 	try {
-		await P(e);
+		await F(e);
 	} catch (e) {
-		F.warn("start bundle build failed — `voltro start` will use the slower per-module boot", {}, e);
+		I.warn("start bundle build failed — `voltro start` will use the slower per-module boot", {}, e);
 	}
-	F.info(`pre-rendered ${M.length} static route(s)`, {
+	I.info(`pre-rendered ${M.length} static route(s)`, {
 		count: M.length,
 		routes: M.map((e) => e.pattern)
 	});
 	try {
 		let e = process.env.VOLTRO_SEO_NOINDEX !== "1", r = n.seo?.siteUrl, i = n.locales ?? [], a = n.defaultLocale ?? i[0];
-		if (r && !O(E(p, "sitemap.xml"))) {
-			let n = new Set(i.filter((e) => e !== a)), o = M.filter((e) => !e.noIndex).map((e) => e.pattern).filter((e) => {
-				let t = e.split("/").filter(Boolean)[0];
-				return t === void 0 || !n.has(t);
-			}).filter((e) => !e.includes("[")).map((e) => ({ path: e })), s = t({
+		if (r && !k(D(p, "sitemap.xml"))) {
+			let t = new Set(i.filter((e) => e !== a)), n = M.filter((e) => !e.noIndex).map((e) => e.pattern).filter((e) => {
+				let n = e.split("/").filter(Boolean)[0];
+				return n === void 0 || !t.has(n);
+			}).filter((e) => !e.includes("[")).map((e) => ({ path: e })), o = l({
 				siteUrl: r,
-				entries: o,
+				entries: n,
 				...i.length > 1 ? { locales: i } : {},
 				...a ? { defaultLocale: a } : {}
 			});
-			await k.writeFile(E(p, "sitemap.xml"), s, "utf8"), F.info("wrote dist/sitemap.xml", {
-				urls: o.length,
+			await A.writeFile(D(p, "sitemap.xml"), o, "utf8"), I.info("wrote dist/sitemap.xml", {
+				urls: n.length,
 				indexable: e
 			});
 		}
-		if (!O(E(p, "robots.txt"))) {
-			let t = o({
+		if (!k(D(p, "robots.txt"))) {
+			let i = t({
 				indexable: e,
 				...e && r ? { sitemapUrl: `${r.replace(/\/$/, "")}/sitemap.xml` } : {},
 				...n.seo?.disallow ? { disallow: n.seo.disallow } : {}
 			});
-			await k.writeFile(E(p, "robots.txt"), t, "utf8"), F.info("wrote dist/robots.txt", { indexable: e });
+			await A.writeFile(D(p, "robots.txt"), i, "utf8"), I.info("wrote dist/robots.txt", { indexable: e });
 		}
 	} catch (e) {
-		F.warn("SEO artefact generation failed (non-fatal)", {}, e);
+		I.warn("SEO artefact generation failed (non-fatal)", {}, e);
 	}
 	try {
-		let t = await w(e);
-		await k.writeFile(E(p, ".voltro-build.json"), JSON.stringify({
+		let t = await T(e);
+		await A.writeFile(D(p, ".voltro-build.json"), JSON.stringify({
 			version: 1,
 			profile: t
-		}, null, 2), "utf8"), F.info("wrote deploy profile manifest", {
+		}, null, 2), "utf8"), I.info("wrote deploy profile manifest", {
 			staticSafe: t.staticSafe,
 			ssr: t.counts.ssr,
 			isr: t.counts.isr
 		});
 	} catch (e) {
-		F.warn("could not write .voltro-build.json deploy manifest", {}, e);
+		I.warn("could not write .voltro-build.json deploy manifest", {}, e);
 	}
-	return F.info("build complete", { distDir: p }), {
+	return I.info("build complete", { distDir: p }), {
 		ran: !0,
 		exitCode: 0
 	};
-}, q = (e) => j.gen(function* () {
-	let t = yield* j.tryPromise({
-		try: () => K(D(e)),
+}, J = (e) => M.gen(function* () {
+	let t = yield* M.tryPromise({
+		try: () => q(O(e)),
 		catch: (e) => e
-	}).pipe(j.orDie);
-	return t.ran ? t.exitCode : (yield* j.logError("no web app found at this path", { hint: "looked for app.config.ts with `type: 'web'`" }), 1);
-}), J = async (t) => {
+	}).pipe(M.orDie);
+	return t.ran ? t.exitCode : (yield* M.logError("no web app found at this path", { hint: "looked for app.config.ts with `type: 'web'`" }), 1);
+}), Y = async (t) => {
 	if (t.includes("--target")) {
-		let { runSdkBuildCommand: e } = await import("./sdkgen-dl4-WKF6.js");
+		let { runSdkBuildCommand: e } = await import("./sdkgen-O4XqWOjM.js");
 		return e(t);
 	}
-	let n = t.find((e) => !e.startsWith("-")) ?? process.cwd(), r = await y(q(n), { scope: "voltro:build" }), i = e(n);
-	return i.warning !== void 0 && F.warn(i.warning), r;
+	let n = t.find((e) => !e.startsWith("-")) ?? process.cwd(), r = await b(J(n), { scope: "voltro:build" }), i = e(n);
+	return i.warning !== void 0 && I.warn(i.warning), r;
 };
 //#endregion
-export { J as runBuildCommand };
+export { Y as runBuildCommand };