@voltro/cli 0.30.2 → 0.32.0

package/dist/{inspectMetrics-BM1vrsga.js → inspectMetrics-BqO4E9G0.js}

@@ -7,11 +7,11 @@ import { FileSystem as v } from "@effect/platform";
 import { NodeContext as y } from "@effect/platform-node";
 import { Effect as b } from "effect";
 import { addSink as x, createLogger as S, printReadyBlock as C } from "@voltro/logger";
-import { closeSync as w, existsSync as T, mkdirSync as E, openSync as D, promises as O, readFileSync as ee, readdirSync as k, statSync as A, unlinkSync as j, unwatchFile as te, watchFile as ne, writeSync as M } from "node:fs";
-import { currentTraceContext as N, recordSample as re, resolveSecret as P } from "@voltro/runtime";
-import { homedir as F } from "node:os";
-import { createRequire as I } from "node:module";
-import { FRAMEWORK_ENV_CATALOG as ie, appEnvEntries as L, checkEnvNaming as R, formatEnvErrors as z, installEnvSnapshot as ae, isEnvContract as B, pluginEnvEntries as oe, renderDotEnvExample as V, resolveEnv as se } from "@voltro/env";
+import { closeSync as w, existsSync as T, mkdirSync as E, openSync as D, promises as O, readFileSync as k, readdirSync as A, statSync as j, unlinkSync as M, unwatchFile as N, watchFile as ee, writeSync as P } from "node:fs";
+import { currentTraceContext as F, recordSample as I, resolveSecret as te } from "@voltro/runtime";
+import { homedir as L } from "node:os";
+import { createRequire as R } from "node:module";
+import { FRAMEWORK_ENV_CATALOG as ne, appEnvEntries as re, checkEnvNaming as z, formatEnvErrors as ie, installEnvSnapshot as B, isEnvContract as ae, pluginEnvEntries as V, renderDotEnvExample as oe, resolveEnv as se } from "@voltro/env";
 import { __installPublicEnv as ce } from "@voltro/env/public";
 import { mkdir as H, readFile as le, writeFile as ue } from "node:fs/promises";
 import { createHash as de } from "node:crypto";
@@ -19,38 +19,38 @@ import { spawn as fe } from "node:child_process";
 import { createConnection as pe } from "node:net";
 import { PassThrough as me } from "node:stream";
 //#region src/agentsMd.ts
-var U = d(g(import.meta.url)), W = [h(U, "..", "templates"), h(U, "..", "..", "templates")], he = (e) => ({
+var he = d(g(import.meta.url)), U = [h(he, "..", "templates"), h(he, "..", "..", "templates")], ge = (e) => ({
 	_tag: "TemplateNotFoundError",
 	searched: e
-}), G = ["AGENTS.md", "CLAUDE.md"], ge = "voltro:agents-md:keep", _e = 2048, ve = "<!-- VOLTRO:INDEX -->", K = (e, t) => e.exists(t).pipe(b.orElseSucceed(() => !1)), q = (e, t) => e.readFileString(t).pipe(b.orElseSucceed(() => "")), ye = (e, t) => e.readFileString(t).pipe(b.map((e) => {
+}), W = ["AGENTS.md", "CLAUDE.md"], _e = "voltro:agents-md:keep", ve = 2048, ye = "<!-- VOLTRO:INDEX -->", G = (e, t) => e.exists(t).pipe(b.orElseSucceed(() => !1)), K = (e, t) => e.readFileString(t).pipe(b.orElseSucceed(() => "")), be = (e, t) => e.readFileString(t).pipe(b.map((e) => {
 	try {
 		return JSON.parse(e).workspaces !== void 0;
 	} catch {
 		return !1;
 	}
-}), b.orElseSucceed(() => !1)), J = (e) => b.gen(function* () {
+}), b.orElseSucceed(() => !1)), q = (e) => b.gen(function* () {
 	let t = yield* v.FileSystem, n = h(e);
 	for (;;) {
-		if ((yield* K(t, p(n, ".git"))) || (yield* K(t, p(n, "pnpm-workspace.yaml"))) || (yield* ye(t, p(n, "package.json")))) return n;
+		if ((yield* G(t, p(n, ".git"))) || (yield* G(t, p(n, "pnpm-workspace.yaml"))) || (yield* be(t, p(n, "package.json")))) return n;
 		let r = d(n);
 		if (r === n) return h(e);
 		n = r;
 	}
-}), be = (e, t, n) => b.gen(function* () {
+}), xe = (e, t, n) => b.gen(function* () {
 	yield* e.makeDirectory(n, { recursive: !0 }).pipe(b.orElseSucceed(() => void 0));
 	let r = yield* e.readDirectory(t).pipe(b.orElseSucceed(() => []));
 	for (let i of r) {
 		let r = p(t, i), a = p(n, i);
-		(yield* e.stat(r).pipe(b.orElseSucceed(() => null)))?.type === "Directory" ? yield* be(e, r, a) : yield* e.copyFile(r, a).pipe(b.orElseSucceed(() => void 0));
+		(yield* e.stat(r).pipe(b.orElseSucceed(() => null)))?.type === "Directory" ? yield* xe(e, r, a) : yield* e.copyFile(r, a).pipe(b.orElseSucceed(() => void 0));
 	}
-}), xe = (e) => typeof e?.name == "string" && e.name.length > 0 ? e.name.split("#")[0] : null, Se = (e, t) => b.gen(function* () {
+}), Se = (e) => typeof e?.name == "string" && e.name.length > 0 ? e.name.split("#")[0] : null, Ce = (e, t) => b.gen(function* () {
 	let n = p(t, "app.config.ts");
-	if (!(yield* K(e, n))) return null;
+	if (!(yield* G(e, n))) return null;
 	let r = (yield* b.tryPromise(() => import(_(n).href)).pipe(b.orElseSucceed(() => null)))?.default;
-	return !r || r.type && r.type !== "api" ? r?.type === "web" ? [] : null : (r.plugins ?? []).map(xe).filter((e) => e !== null);
-}), Ce = (e, t) => b.gen(function* () {
+	return !r || r.type && r.type !== "api" ? r?.type === "web" ? [] : null : (r.plugins ?? []).map(Se).filter((e) => e !== null);
+}), we = (e, t) => b.gen(function* () {
 	let n = [], r = [], i = p(t, "apps");
-	if (!(yield* K(e, i))) return {
+	if (!(yield* G(e, i))) return {
 		apis: n,
 		webs: r
 	};
@@ -58,8 +58,8 @@ var U = d(g(import.meta.url)), W = [h(U, "..", "templates"), h(U, "..", "..", "t
 		let a = p(i, t);
 		if ((yield* e.stat(a).pipe(b.orElseSucceed(() => null)))?.type === "Directory") for (let t of yield* e.readDirectory(a).pipe(b.orElseSucceed(() => []))) {
 			let i = p(a, t), o = p(i, "app.config.ts");
-			if (!(yield* K(e, o))) continue;
-			let s = yield* q(e, o);
+			if (!(yield* G(e, o))) continue;
+			let s = yield* K(e, o);
 			/type:\s*['"]web['"]/.test(s) ? r.push(i) : n.push(i);
 		}
 	}
@@ -67,7 +67,7 @@ var U = d(g(import.meta.url)), W = [h(U, "..", "templates"), h(U, "..", "..", "t
 		apis: n,
 		webs: r
 	};
-}), we = (e) => e.replace(/\|/g, "\\|").replace(/\n/g, " ").trim(), Te = (e, t, n) => {
+}), Te = (e) => e.replace(/\|/g, "\\|").replace(/\n/g, " ").trim(), Ee = (e, t, n) => {
 	let r = [
 		"<!-- voltro agent-docs index — regenerated at seed time -->",
 		"## Deep reference (read on demand)",
@@ -79,17 +79,17 @@ var U = d(g(import.meta.url)), W = [h(U, "..", "templates"), h(U, "..", "..", "t
 		"",
 		"| Topic | Open | Summary |",
 		"|---|---|---|",
-		...e.modules.map((e) => `| ${e.title} | \`${n}${e.path}\` | ${we(e.description)} |`),
+		...e.modules.map((e) => `| ${e.title} | \`${n}${e.path}\` | ${Te(e.description)} |`),
 		""
-	], i = new Map(e.plugins.map((e) => [e.pkg, e])), a = t === null ? e.plugins.map((e) => `| ${e.slug} | \`node_modules/${e.pkg}/README.md\` | ${we(e.description)} |`) : t.map((e) => {
+	], i = new Map(e.plugins.map((e) => [e.pkg, e])), a = (e, t) => e.module === void 0 ? `\`node_modules/${t}/README.md\`` : `\`${n}${e.module}\` (or \`node_modules/${t}/README.md\`)`, o = t === null ? e.plugins.map((e) => `| ${e.slug} | ${a(e, e.pkg)} | ${Te(e.description)} |`) : t.map((e) => {
 		let t = i.get(e);
-		return t ? `| ${t.slug} | \`node_modules/${e}/README.md\` | ${we(t.description)} |` : `| ${e.replace(/^@[^/]+\//, "")} | \`node_modules/${e}/README.md\` | (see plugin README) |`;
+		return t ? `| ${t.slug} | ${a(t, e)} | ${Te(t.description)} |` : `| ${e.replace(/^@[^/]+\//, "")} | \`node_modules/${e}/README.md\` | (see plugin README) |`;
 	});
-	return r.push(`### Plugins${t === null ? "" : " (installed)"}`, "", "| Plugin | Open | Summary |", "|---|---|---|"), r.push(a.length ? a.join("\n") : "| _(none installed)_ | | |", ""), r.join("\n");
-}, Ee = (e, t, n) => {
+	return r.push(`### Plugins${t === null ? "" : " (installed)"}`, "", "| Plugin | Open | Summary |", "|---|---|---|"), r.push(o.length ? o.join("\n") : "| _(none installed)_ | | |", ""), r.join("\n");
+}, De = (e, t, n) => {
 	let r = t.templates?.[e] ?? t.templates?.[e.replace(/^frontend-/, "")];
 	return `\nScaffolded from the \`${e}\` template — see \`${r ? `${n}${r}` : `${n}agent-docs/templates/overview.md`}\`.\n`;
-}, De = {
+}, Oe = {
 	api: (e, t, n = "") => `# api — agent notes
 
 You are in a Voltro **api** app. Server primitives live here: \`queries/\`,
@@ -129,7 +129,7 @@ You are in a Voltro **web** app. File-based routing under \`src/pages/**\`.
 Deep reference (paths from the repo root): \`${e}agent-docs/routing.md\`,
 \`${e}agent-docs/schema-driven-ui.md\`, \`${e}agent-docs/internationalization.md\`.
 ${t}`
-}, Oe = [
+}, ke = [
 	{
 		name: "voltro-schema",
 		description: "Define or change a Voltro database table/schema (columns, mixins, indexes, relations).",
@@ -160,7 +160,7 @@ ${t}`
 		description: "Export/import + backup/restore Voltro data & assets, and copy prod→dev/stage SAFELY with fail-closed masking/anonymization (.sensitive()/.safe()) + referential subsetting. Use for data takeout, seeding lower envs, backups, or cross-dialect moves.",
 		module: "cli.md"
 	}
-], ke = (e, t) => `---
+], Ae = (e, t) => `---
 name: ${e.name}
 description: ${e.description}
 ---
@@ -171,10 +171,10 @@ Open the full reference and follow the patterns there:
 
 Also read the repo-root \`AGENTS.md\` for the always-true rules (browser/server
 boundary, naming, anti-patterns) before editing.
-`, Ae = (e, t, n, r) => b.gen(function* () {
-	let i = yield* K(e, t);
+`, je = (e, t, n, r) => b.gen(function* () {
+	let i = yield* G(e, t);
 	if (i) {
-		if ((yield* q(e, t)).slice(0, _e).includes("voltro:agents-md:keep")) return {
+		if ((yield* K(e, t)).slice(0, ve).includes("voltro:agents-md:keep")) return {
 			path: t,
 			action: "protected"
 		};
@@ -187,67 +187,67 @@ boundary, naming, anti-patterns) before editing.
 		path: t,
 		action: i ? "overwritten" : "created"
 	};
-}), je = (e, t = {}) => b.gen(function* () {
-	let n = yield* v.FileSystem, r = yield* J(e), i = null;
-	for (let e of W) if (yield* K(n, p(e, "AGENTS.core.md"))) {
+}), Me = (e, t = {}) => b.gen(function* () {
+	let n = yield* v.FileSystem, r = yield* q(e), i = null;
+	for (let e of U) if (yield* G(n, p(e, "AGENTS.core.md"))) {
 		i = e;
 		break;
 	}
 	if (i === null) {
-		for (let e of W) if (yield* K(n, p(e, "AGENTS.md"))) {
-			let i = yield* q(n, p(e, "AGENTS.md")), a = [];
-			for (let e of G) a.push(yield* Ae(n, p(r, e), i, t.force ?? !1));
+		for (let e of U) if (yield* G(n, p(e, "AGENTS.md"))) {
+			let i = yield* K(n, p(e, "AGENTS.md")), a = [];
+			for (let e of W) a.push(yield* je(n, p(r, e), i, t.force ?? !1));
 			return { files: a };
 		}
-		return yield* b.fail(he(W.map((e) => p(e, "AGENTS.core.md"))));
+		return yield* b.fail(ge(U.map((e) => p(e, "AGENTS.core.md"))));
 	}
-	let a = yield* q(n, p(i, "AGENTS.core.md")), o = yield* q(n, p(i, "agent-docs", "_manifest.json")), s = o ? JSON.parse(o) : {
+	let a = yield* K(n, p(i, "AGENTS.core.md")), o = yield* K(n, p(i, "agent-docs", "_manifest.json")), s = o ? JSON.parse(o) : {
 		modules: [],
 		plugins: []
-	}, c = (t.preferPointer ?? !1) || (yield* K(n, p(r, "node_modules/@voltro/cli/templates/agent-docs", "_manifest.json"))), l = c ? "node_modules/@voltro/cli/templates/" : "", u = t.force ?? !1, d = G.map((e) => p(r, e));
-	if ((yield* b.forEach(d, (e) => q(n, e).pipe(b.map((e) => e.slice(0, _e))))).every((e) => e.includes("voltro:agents-md:keep"))) return { files: d.map((e) => ({
+	}, c = (t.preferPointer ?? !1) || (yield* G(n, p(r, "node_modules/@voltro/cli/templates/agent-docs", "_manifest.json"))), l = c ? "node_modules/@voltro/cli/templates/" : "", u = t.force ?? !1, d = W.map((e) => p(r, e));
+	if ((yield* b.forEach(d, (e) => K(n, e).pipe(b.map((e) => e.slice(0, ve))))).every((e) => e.includes("voltro:agents-md:keep"))) return { files: d.map((e) => ({
 		path: e,
 		action: "protected"
 	})) };
-	let { apis: f, webs: m } = yield* Ce(n, r), g = /* @__PURE__ */ new Map(), _ = /* @__PURE__ */ new Set(), y = !1;
+	let { apis: f, webs: m } = yield* we(n, r), g = /* @__PURE__ */ new Map(), _ = /* @__PURE__ */ new Set(), y = !1;
 	for (let e of f) {
-		let t = yield* Se(n, e);
+		let t = yield* Ce(n, e);
 		if (g.set(e, t), t !== null) {
 			y = !0;
 			for (let e of t) _.add(e);
 		}
 	}
-	let x = t.plugins ? t.plugins.map(xe).filter((e) => e !== null) : y ? [..._] : null, S = a.includes(ve) ? a.replace(ve, Te(s, x, l)) : a, C = [];
-	for (let e of d) C.push(yield* Ae(n, e, S, u));
-	c || (yield* be(n, p(i, "agent-docs"), p(r, "agent-docs")));
+	let x = t.plugins ? t.plugins.map(Se).filter((e) => e !== null) : y ? [..._] : null, S = a.includes(ye) ? a.replace(ye, Ee(s, x, l)) : a, C = [];
+	for (let e of d) C.push(yield* je(n, e, S, u));
+	c || (yield* xe(n, p(i, "agent-docs"), p(r, "agent-docs")));
 	let w = new Map((t.appTemplates ?? []).map((e) => [h(e.dir), e.template])), T = (e) => {
 		let t = w.get(h(e));
-		return t ? Ee(t, s, l) : "";
-	}, E = (e, t) => b.forEach(G, (r) => Ae(n, p(e, r), t, u));
-	for (let e of f) C.push(...yield* E(e, De.api(l, g.get(e) ?? null, T(e)))), (yield* K(n, p(e, "database"))) && C.push(...yield* E(p(e, "database"), De.database(l)));
-	for (let e of m) C.push(...yield* E(e, De.web(l, T(e))));
-	for (let e of Oe) C.push(yield* Ae(n, p(r, ".claude", "skills", e.name, "SKILL.md"), ke(e, l), u));
+		return t ? De(t, s, l) : "";
+	}, E = (e, t) => b.forEach(W, (r) => je(n, p(e, r), t, u));
+	for (let e of f) C.push(...yield* E(e, Oe.api(l, g.get(e) ?? null, T(e)))), (yield* G(n, p(e, "database"))) && C.push(...yield* E(p(e, "database"), Oe.database(l)));
+	for (let e of m) C.push(...yield* E(e, Oe.web(l, T(e))));
+	for (let e of ke) C.push(yield* je(n, p(r, ".claude", "skills", e.name, "SKILL.md"), Ae(e, l), u));
 	return { files: C };
-}), Me = (e, t = {}) => b.runPromise(je(e, t).pipe(b.provide(y.layer))), Ne = async (t) => {
+}), Ne = (e, t = {}) => b.runPromise(Me(e, t).pipe(b.provide(y.layer))), Pe = async (t) => {
 	let n = t.includes("--force"), r = t.find((e) => !e.startsWith("-")) ?? process.cwd();
 	return e(b.gen(function* () {
-		let e = yield* je(r, { force: n });
+		let e = yield* Me(r, { force: n });
 		for (let t of e.files) {
-			let e = t.action === "created" ? "wrote" : t.action === "overwritten" ? "overwrote" : t.action === "protected" ? `protected (hand-maintained — has "${ge}")` : "present (use --force to overwrite)";
+			let e = t.action === "created" ? "wrote" : t.action === "overwritten" ? "overwrote" : t.action === "protected" ? `protected (hand-maintained — has "${_e}")` : "present (use --force to overwrite)";
 			yield* b.logInfo(`${t.path.split("/").slice(-2).join("/")} ${e}`, { action: t.action });
 		}
 		return 0;
 	}).pipe(b.catchTag("TemplateNotFoundError", (e) => b.gen(function* () {
 		return yield* b.logError("AGENTS.md template not found", { searched: e.searched }), 1;
 	}))), { scope: "voltro:agents-md" });
-}, Pe = p(F(), ".voltro"), Fe = p(Pe, "runtime-registry.json"), Ie = 3e4, Le = () => {
+}, Fe = p(L(), ".voltro"), Ie = p(Fe, "runtime-registry.json"), Le = 3e4, Re = () => {
 	let e = Math.random().toString(36).slice(2, 10);
-	return `${Fe}.${process.pid}.${Date.now()}.${e}.tmp`;
-}, Re = async () => {
-	await O.mkdir(Pe, { recursive: !0 });
+	return `${Ie}.${process.pid}.${Date.now()}.${e}.tmp`;
 }, ze = async () => {
+	await O.mkdir(Fe, { recursive: !0 });
+}, Be = async () => {
 	try {
-		let e = await O.readFile(Fe, "utf8"), t = JSON.parse(e);
+		let e = await O.readFile(Ie, "utf8"), t = JSON.parse(e);
 		return t.version !== 1 || !Array.isArray(t.apps) ? {
 			version: 1,
 			apps: []
@@ -258,34 +258,34 @@ boundary, naming, anti-patterns) before editing.
 			apps: []
 		};
 	}
-}, Be = async (e) => {
-	await Re();
-	let t = Le();
+}, Ve = async (e) => {
+	await ze();
+	let t = Re();
 	try {
 		await O.writeFile(t, JSON.stringify(e, null, 2), {
 			encoding: "utf8",
 			mode: 384
-		}), await O.rename(t, Fe), await O.chmod(Fe, 384).catch(() => {});
+		}), await O.rename(t, Ie), await O.chmod(Ie, 384).catch(() => {});
 	} catch (e) {
 		try {
 			await O.unlink(t);
 		} catch {}
 		throw e;
 	}
-}, Ve = (e) => {
+}, He = (e) => {
 	try {
 		return process.kill(e, 0), !0;
 	} catch {
 		return !1;
 	}
-}, He = (e) => {
+}, Ue = (e) => {
 	let t = Date.now();
-	return e.filter((e) => Ve(e.pid) ? t - new Date(e.heartbeatAt).getTime() < Ie : !1);
-}, Ue = async () => {
-	let e = await ze(), t = He(e.apps);
+	return e.filter((e) => He(e.pid) ? t - new Date(e.heartbeatAt).getTime() < Le : !1);
+}, We = async () => {
+	let e = await Be(), t = Ue(e.apps);
 	if (t.length === e.apps.length) return e;
 	try {
-		await Be({
+		await Ve({
 			version: 1,
 			apps: t
 		});
@@ -294,31 +294,31 @@ boundary, naming, anti-patterns) before editing.
 		version: 1,
 		apps: t
 	};
-}, We = async (e) => {
-	let t = await ze(), n = (/* @__PURE__ */ new Date()).toISOString(), r = t.apps.findIndex((t) => t.id === e.id), i = e.inspectToken ?? process.env.VOLTRO_INSPECT_TOKEN, a = {
+}, Ge = async (e) => {
+	let t = await Be(), n = (/* @__PURE__ */ new Date()).toISOString(), r = t.apps.findIndex((t) => t.id === e.id), i = e.inspectToken ?? process.env.VOLTRO_INSPECT_TOKEN, a = {
 		...e,
 		...i !== void 0 && i !== "" ? { inspectToken: i } : {},
 		registeredAt: r >= 0 ? t.apps[r].registeredAt : n,
 		heartbeatAt: n
 	};
-	await Be({
+	await Ve({
 		version: 1,
 		apps: r >= 0 ? t.apps.map((e, t) => t === r ? a : e) : [...t.apps, a]
 	});
-}, Ge = async (e) => {
+}, Ke = async (e) => {
 	try {
-		let t = await ze(), n = t.apps.filter((t) => t.id !== e);
+		let t = await Be(), n = t.apps.filter((t) => t.id !== e);
 		if (n.length === t.apps.length) return;
-		await Be({
+		await Ve({
 			version: 1,
 			apps: n
 		});
 	} catch {}
-}, Ke = (e, t, n) => `${e}:${t}:${n}`, qe = (e) => e.replace(/\\"|"(?:[^"\\]|\\.)*"|(\/\/[^\n]*|\/\*[\s\S]*?\*\/)/g, (e, t) => t ? "" : e), Je = (e) => {
+}, qe = (e, t, n) => `${e}:${t}:${n}`, Je = (e) => e.replace(/\\"|"(?:[^"\\]|\\.)*"|(\/\/[^\n]*|\/\*[\s\S]*?\*\/)/g, (e, t) => t ? "" : e), Ye = (e) => {
 	try {
 		let t = p(e, "tsconfig.json");
 		if (!T(t)) return [];
-		let n = JSON.parse(qe(ee(t, "utf8"))).compilerOptions ?? {}, r = n.paths ?? {}, i = h(e, n.baseUrl ?? "."), a = [];
+		let n = JSON.parse(Je(k(t, "utf8"))).compilerOptions ?? {}, r = n.paths ?? {}, i = h(e, n.baseUrl ?? "."), a = [];
 		for (let [e, t] of Object.entries(r)) {
 			let n = t[0];
 			if (!n) continue;
@@ -338,17 +338,17 @@ boundary, naming, anti-patterns) before editing.
 	} catch {
 		return [];
 	}
-}, Ye = (e) => {
+}, Xe = (e) => {
 	let t = e;
 	return t?.code === "ERR_MODULE_NOT_FOUND" || /Cannot find (package|module)/.test(String(t?.message ?? ""));
-}, Xe = async (e, t) => {
+}, Ze = async (e, t) => {
 	try {
 		return await t();
 	} catch (t) {
-		throw Ye(t) ? Error(`voltro: the build tool '${e}' is not installed.\n\nIt's an OPTIONAL dependency of @voltro/cli — needed by 'voltro dev' and 'voltro build', but excluded from a serve-only production install (that's how prod images stay lean). If you are building, reinstall WITHOUT '--no-optional' (e.g. 'pnpm install'). A production SERVE container does not need '${e}' — it boots from the precompiled bundle.`) : t;
+		throw Xe(t) ? Error(`voltro: the build tool '${e}' is not installed.\n\nIt's an OPTIONAL dependency of @voltro/cli — needed by 'voltro dev' and 'voltro build', but excluded from a serve-only production install (that's how prod images stay lean). If you are building, reinstall WITHOUT '--no-optional' (e.g. 'pnpm install'). A production SERVE container does not need '${e}' — it boots from the precompiled bundle.`) : t;
 	}
-}, Ze = "// AUTO-GENERATED by Voltro — DO NOT EDIT.\n// Source: app.config.ts `env` (defineEnv). Regenerated on every `voltro dev` boot.\n", Qe = (e, t) => t ? `${e} | undefined` : e, $e = (e, t) => Object.entries(e.vars).filter(([, e]) => t(e.access)).map(([e, t]) => `${t.description ? `    /** ${t.description} */\n` : ""}    readonly ${e}: ${Qe(t.tsType, t.optional)}`).join("\n"), et = async (e, t) => {
-	let n = $e(t, () => !0), r = `${Ze}
+}, Qe = "// AUTO-GENERATED by Voltro — DO NOT EDIT.\n// Source: app.config.ts `env` (defineEnv). Regenerated on every `voltro dev` boot.\n", $e = (e, t) => t ? `${e} | undefined` : e, et = (e, t) => Object.entries(e.vars).filter(([, e]) => t(e.access)).map(([e, t]) => `${t.description ? `    /** ${t.description} */\n` : ""}    readonly ${e}: ${$e(t.tsType, t.optional)}`).join("\n"), tt = async (e, t) => {
+	let n = et(t, () => !0), r = `${Qe}
 import '@voltro/env/server'
 
 declare module '@voltro/env/server' {
@@ -358,8 +358,8 @@ ${n.length > 0 ? n : "    // (no variables declared)"}
 }
 `;
 	await ue(p(e, "env.generated.d.ts"), r, "utf8");
-}, tt = async (e, t) => {
-	let n = $e(t, (e) => e === "public"), r = `${Ze}
+}, nt = async (e, t) => {
+	let n = et(t, (e) => e === "public"), r = `${Qe}
 import '@voltro/env/public'
 
 declare module '@voltro/env/public' {
@@ -369,8 +369,8 @@ ${n.length > 0 ? n : "    // (no public variables declared)"}
 }
 `, i = p(e, "src");
 	await H(i, { recursive: !0 }), await ue(p(i, "voltro-env.d.ts"), r, "utf8");
-}, nt = async (e, t) => {
-	let n = `${Ze}
+}, rt = async (e, t) => {
+	let n = `${Qe}
 import { __installPublicEnv } from '@voltro/env/public'
 
 export const publicEnvValues = ${JSON.stringify(t, null, 2)} as const
@@ -379,13 +379,13 @@ export const publicEnvValues = ${JSON.stringify(t, null, 2)} as const
 __installPublicEnv(publicEnvValues)
 `;
 	await H(e, { recursive: !0 }), await ue(p(e, "env.public.ts"), n, "utf8");
-}, rt = async (e) => {
-	let t = B(e.rawEnv) ? e.rawEnv : void 0, n = await se({
+}, it = async (e) => {
+	let t = ae(e.rawEnv) ? e.rawEnv : void 0, n = await se({
 		contract: t,
-		resolveSecret: P
-	}), r = [...n.errors, ...R(t, e.appType)];
-	if (r.length > 0) throw Error(z(r));
-	ae(n.values), e.appType === "web" && ce(n.publicValues);
+		resolveSecret: te
+	}), r = [...n.errors, ...z(t, e.appType)];
+	if (r.length > 0) throw Error(ie(r));
+	B(n.values), e.appType === "web" && ce(n.publicValues);
 	let i = t ? Object.keys(t.vars).length : 0;
 	if (i > 0) {
 		let r = Object.keys(n.publicValues).length;
@@ -397,20 +397,20 @@ __installPublicEnv(publicEnvValues)
 			n.length > 0 && e.log.warn(`env: ${n.length} secret var(s) declared on a web app — secrets are reachable only from server-side render code and are NEVER bundled. Prefer declaring secrets on the api.`, { keys: n });
 		}
 	}
-	return e.generateTypes && t && (e.appType === "api" ? await et(e.root, t) : await tt(e.root, t)), {
+	return e.generateTypes && t && (e.appType === "api" ? await tt(e.root, t) : await nt(e.root, t)), {
 		resolved: n,
 		contract: t
 	};
-}, it = (e) => {
-	let t = L(e.contract), n = (e.plugins ?? []).flatMap((e) => oe(e.name, e.declaredEnv)), r = e.includeFramework === !1 ? [] : ie, i = /* @__PURE__ */ new Set(), a = [];
+}, at = (e) => {
+	let t = re(e.contract), n = (e.plugins ?? []).flatMap((e) => V(e.name, e.declaredEnv)), r = e.includeFramework === !1 ? [] : ne, i = /* @__PURE__ */ new Set(), a = [];
 	for (let e of [
 		...t,
 		...n,
 		...r
 	]) i.has(e.key) || (i.add(e.key), a.push(e));
 	return a;
-}, at = (e, t, n = (e) => process.env[e]) => {
-	let r = it(t).map((e) => {
+}, ot = (e, t, n = (e) => process.env[e]) => {
+	let r = at(t).map((e) => {
 		let t = n(e.key) !== void 0;
 		return {
 			...e,
@@ -427,13 +427,13 @@ __installPublicEnv(publicEnvValues)
 			missingRequired: r.filter((e) => e.required && !e.isSet && e.default === void 0).length
 		}
 	};
-}, ot = (e, t) => V(it({
+}, st = (e, t) => oe(at({
 	...e,
 	includeFramework: !1
 }), {
 	includeFramework: e.includeFramework !== !1,
 	...t ? { header: t } : {}
-}), st = () => {
+}), ct = () => {
 	let e = /* @__PURE__ */ new Map();
 	return {
 		get(t) {
@@ -460,7 +460,7 @@ __installPublicEnv(publicEnvValues)
 			return Array.from(e.entries());
 		}
 	};
-}, ct = (e) => {
+}, lt = (e) => {
 	if (typeof e == "number" && Number.isFinite(e) && e > 0) return e * 1e3;
 	if (typeof e != "string") return null;
 	let t = /^\s*(\d+)\s*(s|seconds?|m|minutes?|h|hours?|d|days?)\s*$/i.exec(e);
@@ -469,20 +469,20 @@ __installPublicEnv(publicEnvValues)
 	if (!Number.isFinite(n) || n <= 0) return null;
 	let r = t[2].toLowerCase();
 	return r === "s" || r.startsWith("second") ? n * 1e3 : r === "m" || r.startsWith("minute") ? n * 6e4 : r === "h" || r.startsWith("hour") ? n * 36e5 : r === "d" || r.startsWith("day") ? n * 864e5 : null;
-}, lt = (e, t = {}) => {
+}, ut = (e, t = {}) => {
 	let n = [e];
 	return t.tenant !== void 0 && t.tenant !== "" && n.push(`tenant=${t.tenant}`), t.locale !== void 0 && t.locale !== "" && n.push(`lang=${t.locale}`), n.join("|");
-}, ut = (e, t) => e.expiresAt > t, dt = (e, t) => e.expiresAt <= t && e.servableUntil > t, ft = S({ scope: "voltro:cli" }), pt = (e, t) => {
+}, dt = (e, t) => e.expiresAt > t, ft = (e, t) => e.expiresAt <= t && e.servableUntil > t, pt = S({ scope: "voltro:cli" }), mt = (e, t) => {
 	if (t?.code !== "EACCES") return "";
 	if (typeof process.getuid != "function") return " — permission denied";
 	try {
-		let t = A(e);
+		let t = j(e);
 		return ` — permission denied: the file is owned by uid ${t.uid} (mode ${(t.mode & 511).toString(8)}) and this process is uid ${process.getuid()}. A container running as root with the workspace bind-mounted writes files the host user cannot read; run it as \`--user <your-uid>:<your-gid>\`, or delete the file and let the owning user recreate it.`;
 	} catch {
 		return " — permission denied (and the file could not be stat-ed either)";
 	}
-}, mt = [], ht = (e) => {
-	mt.length = 0;
+}, ht = [], gt = (e) => {
+	ht.length = 0;
 	let t = e[1] && !e[1].startsWith("-") ? e[1] : void 0, n = t ? f(t) ? t : h(process.cwd(), t) : process.cwd(), r = [], i = n;
 	for (;;) {
 		r.push(i);
@@ -493,9 +493,9 @@ __installPublicEnv(publicEnvValues)
 	for (let e of r) for (let t of [".env.local", ".env"]) {
 		let n = h(e, t);
 		if (T(n)) {
-			mt.push(n);
+			ht.push(n);
 			try {
-				let e = ee(n, "utf8");
+				let e = k(n, "utf8");
 				for (let t of e.split(/\r?\n/)) {
 					let e = t.trim();
 					if (e === "" || e.startsWith("#")) continue;
@@ -505,11 +505,11 @@ __installPublicEnv(publicEnvValues)
 					(i.startsWith("\"") && i.endsWith("\"") || i.startsWith("'") && i.endsWith("'")) && (i = i.slice(1, -1)), process.env[r] === void 0 && (process.env[r] = i);
 				}
 			} catch (e) {
-				ft.warn(`failed to load env file (continuing)${pt(n, e)}`, { path: n }, e);
+				pt.warn(`failed to load env file (continuing)${mt(n, e)}`, { path: n }, e);
 			}
 		}
 	}
-}, gt = 500, _t = (e, t, n = {}) => {
+}, _t = 500, vt = (e, t, n = {}) => {
 	if (e.length === 0) return () => {};
 	let r = (e) => n.root ? m(n.root, e) : e, i = !1, a = (e) => {
 		i || (i = !0, t.warn(`.env changed (${r(e)}) — hard-restarting: process.env is read once at boot, a reload would keep stale values`, { file: r(e) }), Promise.resolve().then(() => n.onBeforeRestart?.()).catch((e) => t.warn(".env restart: onBeforeRestart failed (continuing)", {}, e)).finally(() => {
@@ -527,62 +527,294 @@ __installPublicEnv(publicEnvValues)
 			});
 		}));
 	};
-	for (let t of e) ne(t, { interval: gt }, (e, n) => {
+	for (let t of e) ee(t, { interval: _t }, (e, n) => {
 		e.mtimeMs !== n.mtimeMs && a(t);
 	});
 	return t.info("watching .env files for changes", {
 		files: e.map(r),
-		intervalMs: gt
+		intervalMs: _t
 	}), () => {
-		for (let t of e) te(t);
+		for (let t of e) N(t);
+	};
+}, yt = "VoltroBootRefusal", bt = (e) => {
+	let t = Error(e);
+	return t.name = yt, t;
+}, xt = [{
+	host: "127.0.0.1",
+	family: "IPv4"
+}, {
+	host: "::1",
+	family: "IPv6"
+}], St = (e, t, n) => new Promise((r) => {
+	let i = !1, a = (e) => {
+		if (!i) {
+			i = !0;
+			try {
+				o.destroy();
+			} catch {}
+			r(e);
+		}
+	}, o = pe({
+		host: e,
+		port: t
+	});
+	o.once("connect", () => a(!0)), o.once("error", () => a(!1)), o.setTimeout(n, () => a(!1));
+}), Ct = async (e, t = 400) => ({ families: (await Promise.all(xt.map(async (n) => ({
+	family: n.family,
+	taken: await St(n.host, e, t)
+})))).filter((e) => e.taken).map((e) => e.family) }), wt = (e, t, n) => [
+	`${t}: port ${e} is already being served (${n.join(" + ")}).`,
+	"",
+	"  Refusing to start. This is NOT a spurious check — a second listener can",
+	"  bind the SAME port on the other IP stack, so the boot would report",
+	`  "listening on http://localhost:${e}" and "ready", while every request`,
+	"  went to the process that is already there. Your edits would have no",
+	"  effect and nothing would say so.",
+	"",
+	"  Find it and stop it:",
+	"",
+	`    lsof -nP -iTCP:${e} -sTCP:LISTEN`,
+	"",
+	"  Then re-run. To use a different port instead, change `port` in",
+	"  app.config.ts."
+].join("\n"), Tt = async (e, t) => {
+	let { families: n } = await Ct(e);
+	if (n.length !== 0) throw bt(wt(e, t, n));
+}, Et = (e) => e === "effect" || e.startsWith("@effect/") || e.startsWith("@voltro/") || e === "react" || e === "react-dom", Dt = /(^|\/)(\.bin|\.cache|\.pnpm-store|dist|build)(\/|$)/, Ot = (e) => {
+	let t = [], n = e;
+	for (let e = 0; e < 12; e++) {
+		let e = p(n, "node_modules");
+		T(e) && t.push(e);
+		let r = d(n);
+		if (r === n) break;
+		n = r;
+	}
+	return t;
+}, kt = (e) => {
+	let t = /* @__PURE__ */ new Set([e]), n = e;
+	for (let e = 0; e < 12; e++) {
+		for (let e of ["pnpm-workspace.yaml", "pnpm-workspace.yml"]) {
+			let r;
+			try {
+				r = k(p(n, e), "utf8");
+			} catch {
+				continue;
+			}
+			for (let e of r.matchAll(/^\s*-\s*['"]?([^'"\n#]+?)['"]?\s*$/gm)) {
+				let r = (e[1] ?? "").trim();
+				if (r === "" || r.startsWith("!")) continue;
+				let i = r.split("/")[0] ?? "";
+				if (i === "" || i.includes("*")) continue;
+				let a;
+				try {
+					a = A(p(n, i), { withFileTypes: !0 });
+				} catch {
+					continue;
+				}
+				for (let e of a) e.isDirectory() && t.add(p(n, i, e.name));
+			}
+		}
+		for (let e of ["packages", "apps"]) {
+			let r;
+			try {
+				r = A(p(n, e), { withFileTypes: !0 });
+			} catch {
+				continue;
+			}
+			for (let i of r) i.isDirectory() && t.add(p(n, e, i.name));
+		}
+		let e = d(n);
+		if (e === n) break;
+		n = e;
+	}
+	return [...t];
+}, At = (e) => {
+	let t = [];
+	for (let n of kt(e)) {
+		let e = p(n, "node_modules", "@voltro"), r;
+		try {
+			r = A(e);
+		} catch {
+			continue;
+		}
+		for (let n of r) {
+			let r = p(e, n), i = jt(r);
+			i !== void 0 && t.push({
+				pkg: `@voltro/${n}`,
+				version: i,
+				dir: r
+			});
+		}
+	}
+	return t;
+}, jt = (e) => {
+	try {
+		let t = JSON.parse(k(p(e, "package.json"), "utf8"));
+		return typeof t.version == "string" ? t.version : void 0;
+	} catch {
+		return;
+	}
+}, Mt = (e) => {
+	let t = [], n;
+	try {
+		n = A(e);
+	} catch {
+		return t;
+	}
+	for (let r of n) {
+		if (r.startsWith(".") || Dt.test(r)) continue;
+		let n = p(e, r);
+		if (r.startsWith("@")) {
+			let e;
+			try {
+				e = A(n);
+			} catch {
+				continue;
+			}
+			for (let i of e) t.push({
+				pkg: `${r}/${i}`,
+				dir: p(n, i)
+			});
+			continue;
+		}
+		try {
+			if (!j(n).isDirectory()) continue;
+		} catch {
+			continue;
+		}
+		t.push({
+			pkg: r,
+			dir: n
+		});
+	}
+	return t;
+}, Nt = (e) => {
+	let t = /* @__PURE__ */ new Map(), n = (e, n, r) => {
+		if (!Et(e)) return;
+		let i = t.get(e) ?? /* @__PURE__ */ new Map();
+		i.has(n) || i.set(n, r), t.set(e, i);
 	};
-}, vt = S({ scope: "vite" }), yt = /\x1b\[[0-9;]*m/g, bt = /^\s*\[?vite\]?\s*(\([a-z-]+\)\s*)?/, xt = (e) => e.replace(yt, "").replace(bt, "").trim(), St = /proxy error/i, Ct = [
+	for (let t of Ot(e)) for (let { pkg: e, dir: r } of Mt(t)) {
+		let t = jt(r);
+		t !== void 0 && n(e, t, r);
+	}
+	for (let { pkg: t, version: r, dir: i } of At(e)) n(t, r, i);
+	let r = [];
+	for (let [n, i] of t) i.size < 2 || r.push({
+		pkg: n,
+		versions: [...i.keys()].sort(),
+		paths: [...i.values()].map((t) => m(e, t)).sort()
+	});
+	return r.sort((e, t) => e.pkg.localeCompare(t.pkg));
+}, Pt = (e) => {
+	if (e.length !== 0) return [
+		`•  ${e.length} package(s) resolved at more than one version:`,
+		...e.flatMap((e) => [`     ${e.pkg} — ${e.versions.join(", ")}`, ...e.paths.map((e) => `       ${e}`)]),
+		"",
+		"   Two copies of `effect` (or `@effect/*`) is the usual cause of type errors",
+		"   inside the GENERATED rpcGroup.generated.ts that look like framework bugs:",
+		"   \"Property '[TypeId]' is missing\", \"typeof Never is not assignable to All\",",
+		"   or an `Rpc<…, Stream<…>, …>` that will not go where `Any` is expected.",
+		"   Effect types are nominal, so a Schema built by one copy is not the same",
+		"   type as a Schema expected by the other — and the RUNTIME often still works,",
+		"   which is why this shows up as a red tsc against a green server.",
+		"",
+		"   Fix it in the install, not the code: align the version across the workspace",
+		"   (a root `pnpm.overrides` / `resolutions` entry for `effect` is the blunt",
+		"   instrument), then reinstall. Do not silence the generated file — it is where",
+		"   a genuine mistake in your own descriptors surfaces."
+	].join("\n");
+}, Ft = (e) => {
+	let t = /* @__PURE__ */ new Map();
+	for (let n of Ot(e)) for (let { pkg: e, dir: r } of Mt(n)) {
+		if (!e.startsWith("@voltro/")) continue;
+		let n = jt(r);
+		n !== void 0 && !t.has(e) && t.set(e, n);
+	}
+	if (t.size < 2) return;
+	let n = /* @__PURE__ */ new Map();
+	for (let e of t.values()) n.set(e, (n.get(e) ?? 0) + 1);
+	if (n.size < 2) return;
+	let r = [...n.entries()].sort((e, t) => t[1] - e[1] || e[0].localeCompare(t[0]) * -1)[0][0];
+	return {
+		majority: r,
+		behind: [...t.entries()].filter(([, e]) => e !== r).map(([e, t]) => ({
+			pkg: e,
+			version: t
+		})).sort((e, t) => e.pkg.localeCompare(t.pkg))
+	};
+}, It = (e) => {
+	if (e !== void 0) return [
+		`•  ${e.behind.length} @voltro/* package(s) are not on ${e.majority}:`,
+		...e.behind.map((e) => `     ${e.pkg}  ${e.version}`),
+		"",
+		"   The framework ships in LOCKSTEP — every @voltro/* package carries the",
+		"   same version at release — so this combination was never built or tested",
+		"   as a set. It is not a judgement about whether they are compatible.",
+		"",
+		"   Nothing else will tell you. A consumer carried a package two releases",
+		"   behind through `tsc`, 19 317 tests, `voltro doctor` exit 0 in four apps",
+		"   and three production builds, all green. None of those checks is ABOUT",
+		"   version agreement.",
+		"",
+		"   Bump the listed packages and reinstall. If you bump with a script, check",
+		"   its pattern: the one that produced this report was `@voltro/[a-z-]+`,",
+		"   which silently skips `@voltro/i18n` because the name contains digits."
+	].join("\n");
+}, Lt = (e, t) => {
+	let n = Ft(e);
+	n !== void 0 && t.warn?.(`@voltro/* version skew: ${n.behind.length} package(s) are not on ${n.majority}`, {
+		majority: n.majority,
+		behind: n.behind.map((e) => `${e.pkg}@${e.version}`),
+		fix: "the framework ships in lockstep; bump the listed packages and reinstall"
+	});
+}, Rt = S({ scope: "vite" }), zt = /\x1b\[[0-9;]*m/g, Bt = /^\s*\[?vite\]?\s*(\([a-z-]+\)\s*)?/, Vt = (e) => e.replace(zt, "").replace(Bt, "").trim(), Ht = /proxy error/i, Ut = [
 	"ECONNREFUSED",
 	"ECONNRESET",
 	"ECONNABORTED",
 	"EPIPE",
 	"ETIMEDOUT"
-], wt = (e, t = 0) => {
+], Wt = (e, t = 0) => {
 	if (e == null || t > 5) return !1;
 	let n = e;
-	return typeof n.code == "string" && Ct.includes(n.code) || typeof n.message == "string" && Ct.some((e) => n.message.includes(e)) || Array.isArray(n.errors) && n.errors.some((e) => wt(e, t + 1)) ? !0 : wt(n.cause, t + 1);
-}, Tt = 4e3, Et = () => {
+	return typeof n.code == "string" && Ut.includes(n.code) || typeof n.message == "string" && Ut.some((e) => n.message.includes(e)) || Array.isArray(n.errors) && n.errors.some((e) => Wt(e, t + 1)) ? !0 : Wt(n.cause, t + 1);
+}, Gt = 4e3, Kt = () => {
 	let e = /* @__PURE__ */ new Set(), t = 0, n = {
 		hasWarned: !1,
 		info: (e) => {
-			let t = xt(e);
-			t.length !== 0 && vt.info(t);
+			let t = Vt(e);
+			t.length !== 0 && Rt.info(t);
 		},
 		warn: (e) => {
 			n.hasWarned = !0;
-			let t = xt(e);
-			t.length !== 0 && vt.warn(t);
+			let t = Vt(e);
+			t.length !== 0 && Rt.warn(t);
 		},
 		warnOnce: (t) => {
-			let r = xt(t);
-			e.has(r) || (e.add(r), n.hasWarned = !0, r.length !== 0 && vt.warn(r));
+			let r = Vt(t);
+			e.has(r) || (e.add(r), n.hasWarned = !0, r.length !== 0 && Rt.warn(r));
 		},
 		error: (e, n) => {
-			let r = xt(e), i = n?.error;
+			let r = Vt(e), i = n?.error;
 			if (r.length !== 0) {
-				if (St.test(r) && wt(i)) {
+				if (Ht.test(r) && Wt(i)) {
 					let e = Date.now();
-					e - t > Tt && (t = e, vt.info("waiting for api — proxy upstream not accepting connections yet (still starting?)"));
+					e - t > Gt && (t = e, Rt.info("waiting for api — proxy upstream not accepting connections yet (still starting?)"));
 					return;
 				}
-				vt.error(r, {}, i);
+				Rt.error(r, {}, i);
 			}
 		},
 		clearScreen: () => {},
 		hasErrorLogged: (e) => !1
 	};
 	return n;
-}, Dt = (e = process.env) => {
+}, qt = (e = process.env) => {
 	let t = e.VOLTRO_DEV_SSR_COMPILE_CONCURRENCY;
 	if (t === void 0 || t.trim() === "") return 4;
 	let n = Number(t);
 	return Number.isFinite(n) && n >= 1 ? Math.floor(n) : 4;
-}, Ot = (e) => {
+}, Jt = (e) => {
 	let t = Math.max(1, Math.floor(e)), n = 0, r = [], i = () => n < t ? (n++, Promise.resolve()) : new Promise((e) => r.push(e)), a = () => {
 		let e = r.shift();
 		e ? e() : n--;
@@ -600,8 +832,8 @@ __installPublicEnv(publicEnvValues)
 			return n;
 		}
 	};
-}, kt = (e) => {
-	let t = Ot(e.limit), n = /* @__PURE__ */ new Map(), r = /* @__PURE__ */ new Set();
+}, Yt = (e) => {
+	let t = Jt(e.limit), n = /* @__PURE__ */ new Map(), r = /* @__PURE__ */ new Set();
 	return {
 		load: (i, a) => {
 			if (r.has(i)) return a();
@@ -631,7 +863,7 @@ __installPublicEnv(publicEnvValues)
 			return r.size;
 		}
 	};
-}, At = (e) => {
+}, Xt = (e) => {
 	let t = [];
 	for (let n of e.split("/").filter(Boolean)) n.startsWith("[[...") && n.endsWith("]]") ? t.push({
 		name: n.slice(5, -2),
@@ -647,7 +879,7 @@ __installPublicEnv(publicEnvValues)
 		optional: !1
 	});
 	return t;
-}, jt = (e) => e.replace(/-([a-z0-9])/g, (e, t) => t.toUpperCase()), Mt = async (e) => {
+}, Zt = (e) => e.replace(/-([a-z0-9])/g, (e, t) => t.toUpperCase()), Qt = async (e) => {
 	let t = h(e);
 	for (let e = 0; e < 4; e++) {
 		let e = p(t, "project.json");
@@ -665,8 +897,8 @@ __installPublicEnv(publicEnvValues)
 		t = n;
 	}
 	return null;
-}, Nt = async (e) => {
-	let t = await Mt(e);
+}, $t = async (e) => {
+	let t = await Qt(e);
 	if (!t) return [];
 	let { projectDir: n, manifest: r } = t, i = u(e), a = r.apps ?? {}, o = [];
 	for (let [e, t] of Object.entries(a)) {
@@ -675,23 +907,23 @@ __installPublicEnv(publicEnvValues)
 		if (!T(r)) continue;
 		let a;
 		try {
-			let { pages: e } = await $(r);
+			let { pages: e } = await Q(r);
 			a = e.map((e) => ({
 				pattern: e.pattern,
-				params: At(e.pattern)
+				params: Xt(e.pattern)
 			}));
 		} catch {
 			continue;
 		}
 		o.push({
-			key: jt(e),
+			key: Zt(e),
 			origin: `http://localhost:${t.port}`,
 			...typeof t.origin == "string" && t.origin.length > 0 ? { prodOrigin: t.origin } : {},
 			routes: a
 		});
 	}
 	return o;
-}, Pt = (e) => {
+}, en = (e) => {
 	if (e.params.length === 0) return `'${e.pattern}'`;
 	let t = e.pattern;
 	for (let n of e.params) {
@@ -699,21 +931,21 @@ __installPublicEnv(publicEnvValues)
 		t = t.replace(e, r);
 	}
 	return "`" + t + "`";
-}, Ft = (e) => e.params.length === 0 ? "EmptyParams" : `{ ${e.params.map((e) => {
+}, tn = (e) => e.params.length === 0 ? "EmptyParams" : `{ ${e.params.map((e) => {
 	let t = "string";
 	return e.optional ? `readonly ${e.name}?: ${t}` : `readonly ${e.name}: ${t}`;
-}).join("; ")} }`, It = (e, t, n) => {
-	let r = Ft(e), i = Pt(e), a = t ? "VoltroExternalUrl" : "VoltroRouteUrl", o = t && n ? `${n} + ` : "";
+}).join("; ")} }`, nn = (e, t, n) => {
+	let r = tn(e), i = en(e), a = t ? "VoltroExternalUrl" : "VoltroRouteUrl", o = t && n ? `${n} + ` : "";
 	return e.params.length === 0 ? `() => (${o}${i}) as ${a}` : `({ ${e.params.map((e) => e.name).join(", ")} }: ${r}) => (${o}${i}) as ${a}`;
-}, Lt = (e) => `{\n${[...e].sort((e, t) => e.pattern.localeCompare(t.pattern)).map((e) => `  ${JSON.stringify(e.pattern)}: ${It(e, !1)},`).join("\n")}\n}`, Rt = (e, t) => {
+}, rn = (e) => `{\n${[...e].sort((e, t) => e.pattern.localeCompare(t.pattern)).map((e) => `  ${JSON.stringify(e.pattern)}: ${nn(e, !1)},`).join("\n")}\n}`, an = (e, t) => {
 	if (e.routes.length === 0) return `  ${e.key}: {} as Record<string, never>,`;
-	let n = [...e.routes].sort((e, t) => e.pattern.localeCompare(t.pattern)), r = t === "prod" && e.prodOrigin ? e.prodOrigin : e.origin, i = JSON.stringify(r), a = n.map((e) => `    ${JSON.stringify(e.pattern)}: ${It(e, !0, i)},`);
+	let n = [...e.routes].sort((e, t) => e.pattern.localeCompare(t.pattern)), r = t === "prod" && e.prodOrigin ? e.prodOrigin : e.origin, i = JSON.stringify(r), a = n.map((e) => `    ${JSON.stringify(e.pattern)}: ${nn(e, !0, i)},`);
 	return `  ${e.key}: {\n${a.join("\n")}\n  },`;
-}, zt = async (e) => {
+}, on = async (e) => {
 	let t = e.pages.map((e) => ({
 		pattern: e.pattern,
-		params: At(e.pattern)
-	})), n = await Nt(e.appRoot), r = [
+		params: Xt(e.pattern)
+	})), n = await $t(e.appRoot), r = [
 		"// THIS FILE IS GENERATED — DO NOT EDIT BY HAND.",
 		"// Re-emitted by `voltro dev` whenever `src/pages/**` changes.",
 		"// Type-safe route builders consumed by <Link to={...}>.",
@@ -722,7 +954,7 @@ __installPublicEnv(publicEnvValues)
 		"",
 		"type EmptyParams = Record<string, never>",
 		""
-	].join("\n"), i = e.mode ?? "dev", a = `${r}\n${`export const routes = ${Lt(t)} as const\n`}\n${n.length === 0 ? "export const siblingApps = {} as Record<string, never>\n" : `export const siblingApps = {\n${n.map((e) => Rt(e, i)).join("\n")}\n} as const\n`}`, o = p(e.appRoot, ".framework", "routes.generated.ts");
+	].join("\n"), i = e.mode ?? "dev", a = `${r}\n${`export const routes = ${rn(t)} as const\n`}\n${n.length === 0 ? "export const siblingApps = {} as Record<string, never>\n" : `export const siblingApps = {\n${n.map((e) => an(e, i)).join("\n")}\n} as const\n`}`, o = p(e.appRoot, ".framework", "routes.generated.ts");
 	await O.mkdir(d(o), { recursive: !0 });
 	let s = null;
 	try {
@@ -735,37 +967,37 @@ __installPublicEnv(publicEnvValues)
 		path: o,
 		wrote: !0
 	});
-}, Bt = (e) => {
+}, sn = (e) => {
 	if (e === "" || e === "/") return "/";
 	let t = e.startsWith("/") ? e : `/${e}`;
 	return t.endsWith("/") ? t.slice(0, -1) : t;
-}, Vt = (e, t) => {
-	let n = e.endsWith("/") ? e.slice(0, -1) : e, r = Bt(t);
+}, cn = (e, t) => {
+	let n = e.endsWith("/") ? e.slice(0, -1) : e, r = sn(t);
 	return r === "/" ? `${n}/` : `${n}${r}`;
-}, Ht = (e, t, n) => {
-	let r = Bt(e);
+}, ln = (e, t, n) => {
+	let r = sn(e);
 	return t === n ? r : r === "/" ? `/${t}` : `/${t}${r}`;
-}, Ut = (e) => e.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;"), Wt = (e) => {
+}, un = (e) => e.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;"), dn = (e) => {
 	let { siteUrl: t, entries: n } = e, r = e.locales && e.locales.length > 1 ? e.locales : void 0, i = e.defaultLocale ?? r?.[0] ?? "en", a = r !== void 0, o = /* @__PURE__ */ new Map(), s = (e) => {
 		if (!r) return "";
-		let n = r.map((n) => `    <xhtml:link rel="alternate" hreflang="${Ut(n)}" href="${Ut(Vt(t, Ht(e, n, i)))}" />`);
-		return n.push(`    <xhtml:link rel="alternate" hreflang="x-default" href="${Ut(Vt(t, Ht(e, i, i)))}" />`), `\n${n.join("\n")}`;
+		let n = r.map((n) => `    <xhtml:link rel="alternate" hreflang="${un(n)}" href="${un(cn(t, ln(e, n, i)))}" />`);
+		return n.push(`    <xhtml:link rel="alternate" hreflang="x-default" href="${un(cn(t, ln(e, i, i)))}" />`), `\n${n.join("\n")}`;
 	};
 	for (let e of n) {
 		let n = r ?? [i];
 		for (let r of n) {
-			let n = Vt(t, Ht(e.path, r, i)), a = e.lastmod ? `\n    <lastmod>${Ut(e.lastmod)}</lastmod>` : "";
-			o.set(n, `  <url>\n    <loc>${Ut(n)}</loc>${a}${s(e.path)}\n  </url>`);
+			let n = cn(t, ln(e.path, r, i)), a = e.lastmod ? `\n    <lastmod>${un(e.lastmod)}</lastmod>` : "";
+			o.set(n, `  <url>\n    <loc>${un(n)}</loc>${a}${s(e.path)}\n  </url>`);
 		}
 	}
 	let c = [...o.keys()].sort().map((e) => o.get(e)).join("\n");
 	return `<?xml version="1.0" encoding="UTF-8"?>\n<urlset${a ? " xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\" xmlns:xhtml=\"http://www.w3.org/1999/xhtml\"" : " xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\""}>\n${c}\n</urlset>\n`;
-}, Gt = (e) => {
+}, fn = (e) => {
 	if (!e.indexable) return "User-agent: *\nDisallow: /\n";
 	let t = ["User-agent: *", "Allow: /"];
-	for (let n of e.disallow ?? []) t.push(`Disallow: ${Bt(n)}`);
+	for (let n of e.disallow ?? []) t.push(`Disallow: ${sn(n)}`);
 	return e.sitemapUrl && t.push("", `Sitemap: ${e.sitemapUrl}`), `${t.join("\n")}\n`;
-}, Kt = 256, qt = (e = Kt) => {
+}, pn = 256, mn = (e = pn) => {
 	let t = [], n = /* @__PURE__ */ new Set();
 	return {
 		emit(r, i) {
@@ -788,17 +1020,17 @@ __installPublicEnv(publicEnvValues)
 			return t.slice();
 		}
 	};
-}, Jt = (e) => `event: ${e.channel}\ndata: ${JSON.stringify(e)}\n\n`, Yt = () => `: keep-alive ${Date.now()}\n\n`, Xt = 8e3, Zt = (e, t = Xt) => {
-	let n = $t(e);
+}, hn = (e) => `event: ${e.channel}\ndata: ${JSON.stringify(e)}\n\n`, gn = () => `: keep-alive ${Date.now()}\n\n`, _n = 8e3, vn = (e, t = _n) => {
+	let n = bn(e);
 	return n.length <= t ? n : `${n.slice(0, t)}\n… [voltro] truncated at ${t} chars (${n.length} total)`;
-}, Qt = 4, $t = (e, t = 0, n = /* @__PURE__ */ new Set()) => {
+}, yn = 4, bn = (e, t = 0, n = /* @__PURE__ */ new Set()) => {
 	if (e instanceof Error) {
 		let r = e.stack ?? `${e.name}: ${e.message}`;
 		if (n.has(e)) return `${r}\n  [cycle]`;
 		n.add(e);
 		let i = [];
-		if (t < Qt) if (e instanceof AggregateError && Array.isArray(e.errors)) for (let [r, a] of e.errors.entries()) i.push(`\n  [aggregate ${r}] ${en($t(a, t + 1, n))}`);
-		else e.cause !== void 0 && e.cause !== null && i.push(`\n  [cause] ${en($t(e.cause, t + 1, n))}`);
+		if (t < yn) if (e instanceof AggregateError && Array.isArray(e.errors)) for (let [r, a] of e.errors.entries()) i.push(`\n  [aggregate ${r}] ${xn(bn(a, t + 1, n))}`);
+		else e.cause !== void 0 && e.cause !== null && i.push(`\n  [cause] ${xn(bn(e.cause, t + 1, n))}`);
 		return r + i.join("");
 	}
 	try {
@@ -806,30 +1038,30 @@ __installPublicEnv(publicEnvValues)
 	} catch {
 		return "[unstringifiable thrown value]";
 	}
-}, en = (e) => {
+}, xn = (e) => {
 	let t = e.split("\n");
 	return t.length <= 3 ? e : `${t.slice(0, 3).join("\n")}\n  …`;
-}, tn = {
+}, Sn = {
 	trace: 0,
 	debug: 1,
 	info: 2,
 	warn: 3,
 	error: 4,
 	fatal: 5
-}, nn = 2e3, rn = 200, an = class {
+}, Cn = 2e3, wn = 200, Tn = class {
 	capacity;
 	buffer = [];
-	constructor(e = nn) {
+	constructor(e = Cn) {
 		this.capacity = e;
 	}
 	append(e) {
 		this.buffer.push(e), this.buffer.length > this.capacity && this.buffer.shift();
 	}
 	query(e = {}) {
-		let t = e.since ?? 0, n = e.until ?? Date.now(), r = Math.min(e.max ?? rn, this.capacity), i = e.minLevel === void 0 ? tn.trace : tn[e.minLevel], a = e.scope?.toLowerCase(), o = e.source, s = e.filter?.toLowerCase(), c = e.traceId, l = [];
+		let t = e.since ?? 0, n = e.until ?? Date.now(), r = Math.min(e.max ?? wn, this.capacity), i = e.minLevel === void 0 ? Sn.trace : Sn[e.minLevel], a = e.scope?.toLowerCase(), o = e.source, s = e.filter?.toLowerCase(), c = e.traceId, l = [];
 		for (let e = this.buffer.length - 1; e >= 0 && l.length < r; e--) {
 			let r = this.buffer[e];
-			r.ts < t || r.ts > n || tn[r.level] < i || o !== void 0 && r.source !== o || a !== void 0 && (r.scope === void 0 || !r.scope.toLowerCase().includes(a)) || s !== void 0 && !r.message.toLowerCase().includes(s) || c !== void 0 && r.fields.traceId !== c || l.push(r);
+			r.ts < t || r.ts > n || Sn[r.level] < i || o !== void 0 && r.source !== o || a !== void 0 && (r.scope === void 0 || !r.scope.toLowerCase().includes(a)) || s !== void 0 && !r.message.toLowerCase().includes(s) || c !== void 0 && r.fields.traceId !== c || l.push(r);
 		}
 		return l.reverse();
 	}
@@ -842,7 +1074,7 @@ __installPublicEnv(publicEnvValues)
 	clear() {
 		this.buffer = [];
 	}
-}, on = null, sn = () => (on === null && (on = new an()), on), cn = (e) => {
+}, En = null, Dn = () => (En === null && (En = new Tn()), En), On = (e) => {
 	if (typeof e == "string") return e;
 	if (e instanceof Error) return e.message;
 	try {
@@ -850,28 +1082,28 @@ __installPublicEnv(publicEnvValues)
 	} catch {
 		return String(e);
 	}
-}, ln = 8e3, un = (e) => typeof e == "string" ? e.length <= ln ? e : `${e.slice(0, ln)}… [voltro: truncated]` : typeof e != "object" || !e ? e : Zt(e, ln), dn = (e, t) => {
+}, kn = 8e3, An = (e) => typeof e == "string" ? e.length <= kn ? e : `${e.slice(0, kn)}… [voltro: truncated]` : typeof e != "object" || !e ? e : vn(e, kn), jn = (e, t) => {
 	try {
 		e(...t);
 	} catch (n) {
 		try {
-			e(...t.map(un)), e(`  ↑ [voltro] an argument above was too large for console formatting (${n?.message ?? "inspect failed"}) — printed bounded to ${ln} chars per argument.`);
+			e(...t.map(An)), e(`  ↑ [voltro] an argument above was too large for console formatting (${n?.message ?? "inspect failed"}) — printed bounded to ${kn} chars per argument.`);
 		} catch {
 			e(`[voltro] a console.error argument could not be formatted at all (${t.length} arg(s)).`);
 		}
 	}
-}, fn = (e) => {
+}, Mn = (e) => {
 	let t = {
 		log: console.log.bind(console),
 		info: console.info.bind(console),
 		warn: console.warn.bind(console),
 		error: console.error.bind(console),
 		debug: console.debug.bind(console)
-	}, n = sn(), r = !1, i = (i) => (...a) => {
-		if (dn(t[i], a), !r) {
+	}, n = Dn(), r = !1, i = (i) => (...a) => {
+		if (jn(t[i], a), !r) {
 			r = !0;
 			try {
-				let t = a.length > 0 ? cn(a[0]) : "", r = t.length > 500 ? t.slice(0, 500) + "…" : t, o = N();
+				let t = a.length > 0 ? On(a[0]) : "", r = t.length > 500 ? t.slice(0, 500) + "…" : t, o = F();
 				e.emit("log", {
 					level: i,
 					message: r,
@@ -909,7 +1141,7 @@ __installPublicEnv(publicEnvValues)
 					argsCount: 1,
 					...t.scope === void 0 ? {} : { scope: t.scope }
 				});
-				let a = N(), o = a !== void 0 && t.fields.traceId === void 0 ? {
+				let a = F(), o = a !== void 0 && t.fields.traceId === void 0 ? {
 					...t.fields,
 					traceId: a.traceId
 				} : t.fields;
@@ -929,24 +1161,24 @@ __installPublicEnv(publicEnvValues)
 	return () => {
 		console.log = t.log, console.info = t.info, console.warn = t.warn, console.error = t.error, console.debug = t.debug, a();
 	};
-}, pn = 2e3, mn = 8, hn = 1e3, gn = 200, Y = (e, t) => e.length > t ? `${e.slice(0, t)}…` : e, _n = (e) => {
+}, Nn = 2e3, Pn = 8, Fn = 1e3, In = 200, J = (e, t) => e.length > t ? `${e.slice(0, t)}…` : e, Ln = (e) => {
 	switch (e) {
 		case "error": return "error";
 		case "warn": return "warn";
 		case "debug": return "debug";
 		default: return "info";
 	}
-}, vn = S({ scope: "client" }), yn = (e, t) => {
+}, Rn = S({ scope: "client" }), zn = (e, t) => {
 	let n;
 	try {
 		n = JSON.parse(e);
 	} catch {
-		return bn(400, { error: "invalid JSON body" });
+		return Bn(400, { error: "invalid JSON body" });
 	}
-	if (typeof n != "object" || !n) return bn(400, { error: "body must be a JSON object" });
+	if (typeof n != "object" || !n) return Bn(400, { error: "body must be a JSON object" });
 	let r = n;
-	if (!Array.isArray(r.entries)) return bn(400, { error: "entries must be an array" });
-	let i = typeof r.app == "string" ? Y(r.app, 120) : void 0, a = typeof r.page == "string" ? Y(r.page, 200) : void 0, o = typeof r.ua == "string" ? Y(r.ua, 200) : void 0, s = r.entries.slice(0, gn), c = 0;
+	if (!Array.isArray(r.entries)) return Bn(400, { error: "entries must be an array" });
+	let i = typeof r.app == "string" ? J(r.app, 120) : void 0, a = typeof r.page == "string" ? J(r.page, 200) : void 0, o = typeof r.ua == "string" ? J(r.ua, 200) : void 0, s = r.entries.slice(0, In), c = 0;
 	for (let e of s) {
 		if (typeof e != "object" || !e) continue;
 		let n = e;
@@ -957,7 +1189,7 @@ __installPublicEnv(publicEnvValues)
 			"warn",
 			"error",
 			"debug"
-		].includes(n.level) ? n.level : "log", s = typeof n.ts == "number" && Number.isFinite(n.ts) ? n.ts : Date.now(), l = Y(n.message, pn), u = Array.isArray(n.args) ? n.args.slice(0, mn).filter((e) => typeof e == "string").map((e) => Y(e, hn)) : void 0, d = typeof n.stack == "string" ? Y(n.stack, pn) : void 0;
+		].includes(n.level) ? n.level : "log", s = typeof n.ts == "number" && Number.isFinite(n.ts) ? n.ts : Date.now(), l = J(n.message, Nn), u = Array.isArray(n.args) ? n.args.slice(0, Pn).filter((e) => typeof e == "string").map((e) => J(e, Fn)) : void 0, d = typeof n.stack == "string" ? J(n.stack, Nn) : void 0;
 		t.emit("clientLog", {
 			ts: s,
 			level: r,
@@ -972,35 +1204,35 @@ __installPublicEnv(publicEnvValues)
 			...i === void 0 ? {} : { app: i },
 			...a === void 0 ? {} : { page: a },
 			...u !== void 0 && u.length > 0 ? { args: u } : {}
-		}, p = _n(r);
-		(p === "error" || p === "warn") && d !== void 0 ? vn[p](l, f, { stack: d }) : vn[p](l, {
+		}, p = Ln(r);
+		(p === "error" || p === "warn") && d !== void 0 ? Rn[p](l, f, { stack: d }) : Rn[p](l, {
 			...f,
 			...d === void 0 ? {} : { stack: d }
 		}), c++;
 	}
-	return bn(202, {
+	return Bn(202, {
 		accepted: c,
 		dropped: r.entries.length - c
 	});
-}, bn = (e, t) => ({
+}, Bn = (e, t) => ({
 	status: e,
 	contentType: "application/json; charset=utf-8",
 	body: JSON.stringify(t)
-}), xn = "/_voltro/inspect/clientLog", Sn = [
+}), Vn = "/_voltro/inspect/clientLog", Hn = [
 	"trace",
 	"debug",
 	"info",
 	"warn",
 	"error",
 	"fatal"
-], Cn = {
+], Un = {
 	trace: "TRACE",
 	debug: "DEBUG",
 	info: "INFO ",
 	warn: "WARN ",
 	error: "ERROR",
 	fatal: "FATAL"
-}, wn = (e) => Sn.includes(e), Tn = (e, t, n = {}) => {
+}, Wn = (e) => Hn.includes(e), Gn = (e, t, n = {}) => {
 	if (c()) return {
 		status: 503,
 		contentType: "application/json",
@@ -1031,7 +1263,7 @@ __installPublicEnv(publicEnvValues)
 		Number.isFinite(e) && e > 0 && (o.max = Math.floor(e));
 	}
 	let f = a.get("level");
-	f !== null && wn(f) && (o.minLevel = f);
+	f !== null && Wn(f) && (o.minLevel = f);
 	let p = a.get("source");
 	(p === "server" || p === "client") && (o.source = p);
 	let m = a.get("scope");
@@ -1044,7 +1276,7 @@ __installPublicEnv(publicEnvValues)
 	if ((a.get("format") ?? "json") === "text") return {
 		status: 200,
 		contentType: "text/plain; charset=utf-8",
-		body: _.map(En).join("\n") + (_.length > 0 ? "\n" : "")
+		body: _.map(Kn).join("\n") + (_.length > 0 ? "\n" : "")
 	};
 	let v = {
 		capturedAt: Date.now(),
@@ -1058,40 +1290,40 @@ __installPublicEnv(publicEnvValues)
 		contentType: "application/json; charset=utf-8",
 		body: JSON.stringify(v)
 	};
-}, En = (e) => {
-	let t = new Date(e.ts), n = String(t.getHours()).padStart(2, "0"), r = String(t.getMinutes()).padStart(2, "0"), i = String(t.getSeconds()).padStart(2, "0"), a = String(t.getMilliseconds()).padStart(3, "0"), o = `[${e.scope ?? "?"}/${e.source}]`, s = On(e.fields);
-	return `${n}:${r}:${i}.${a} ${Cn[e.level]} ${o} ${e.message}${s}`;
-}, Dn = 80, On = (e) => {
+}, Kn = (e) => {
+	let t = new Date(e.ts), n = String(t.getHours()).padStart(2, "0"), r = String(t.getMinutes()).padStart(2, "0"), i = String(t.getSeconds()).padStart(2, "0"), a = String(t.getMilliseconds()).padStart(3, "0"), o = `[${e.scope ?? "?"}/${e.source}]`, s = Jn(e.fields);
+	return `${n}:${r}:${i}.${a} ${Un[e.level]} ${o} ${e.message}${s}`;
+}, qn = 80, Jn = (e) => {
 	let t = Object.entries(e);
 	if (t.length === 0) return "";
 	let n = [];
 	for (let [e, r] of t) {
 		if (r === void 0) continue;
-		let t = kn(r);
+		let t = Yn(r);
 		n.push(`${e}=${t}`);
 	}
 	return n.length > 0 ? "  " + n.join(" ") : "";
-}, kn = (e) => {
+}, Yn = (e) => {
 	if (typeof e == "string") {
-		let t = e.length > Dn ? e.slice(0, Dn) + "…" : e;
+		let t = e.length > qn ? e.slice(0, qn) + "…" : e;
 		return /[\s=]/.test(t) ? `"${t.replace(/"/g, "\\\"")}"` : t;
 	}
 	if (e === null) return "null";
 	if (typeof e == "number" || typeof e == "boolean") return String(e);
 	try {
 		let t = JSON.stringify(e);
-		return t.length > Dn ? t.slice(0, Dn) + "…" : t;
+		return t.length > qn ? t.slice(0, qn) + "…" : t;
 	} catch {
 		return "[unserialisable]";
 	}
-}, An = "/_voltro/inspect/logs", jn = (e, t, n) => {
+}, Xn = "/_voltro/inspect/logs", Zn = (e, t, n) => {
 	if (t.headers.authorization !== void 0) return !1;
 	let { token: r } = n;
 	if (r === void 0 || r === "" || !n.isLoopback(n.target)) return !1;
 	e.setHeader("authorization", `Bearer ${r}`);
 	let i = n.writeToken;
 	return i !== void 0 && i !== "" && t.headers["x-voltro-inspect-write"] === void 0 && e.setHeader("x-voltro-inspect-write", i), !0;
-}, Mn = [{
+}, Qn = [{
 	match: (e) => typeof e == "string" && e.startsWith("[BABEL] Note: The code generator has deoptimised"),
 	handle: (e, t) => {
 		let n = e[0], r = n.match(/deoptimised the styling of (.+?) as it exceeds the max of (\d+\w*B)\.?/);
@@ -1103,13 +1335,13 @@ __installPublicEnv(publicEnvValues)
 			});
 		} else t.info(n);
 	}
-}], Nn = () => {
+}], $n = () => {
 	let e = {
 		warn: console.warn.bind(console),
 		error: console.error.bind(console)
 	}, t = S({ scope: "babel" }), n = !1, r = (r) => (...i) => {
 		if (!n) {
-			for (let e of Mn) if (e.match(i[0])) {
+			for (let e of Qn) if (e.match(i[0])) {
 				n = !0;
 				try {
 					e.handle(i, t);
@@ -1124,7 +1356,7 @@ __installPublicEnv(publicEnvValues)
 	return console.warn = r("warn"), console.error = r("error"), () => {
 		console.warn = e.warn, console.error = e.error;
 	};
-}, Pn = {
+}, er = {
 	loader: "it runs on the server, and the router caches its result per route + params",
 	renderMode: "it picks the server render strategy",
 	dynamic: "it picks the server render strategy",
@@ -1135,7 +1367,7 @@ __installPublicEnv(publicEnvValues)
 	cacheInvalidatesOn: "it wires this page into the ISR cache invalidator",
 	interactive: "it decides how much client JS the server ships",
 	tenantAware: "it is part of the server-side cache key"
-}, Fn = Object.keys(Pn), In = (e) => t.test(e), Ln = (e) => e.replace(/page\.tsx$/, "page.test.tsx"), Rn = "virtual:voltro-route-refresh", zn = `\0${Rn}`, Bn = /(?:^|&)(raw|url|inline|worker|sharedworker|direct)(?:&|=|$)/, Vn = () => `
+}, tr = Object.keys(er), nr = (e) => t.test(e), rr = (e) => e.replace(/page\.tsx$/, "page.test.tsx"), ir = "virtual:voltro-route-refresh", ar = `\0${ir}`, or = /(?:^|&)(raw|url|inline|worker|sharedworker|direct)(?:&|=|$)/, sr = () => `
 // GENERATED by @voltro/cli — the \`voltro dev\` route Fast Refresh runtime.
 
 /** Mirrors react-refresh's own \`isLikelyComponentType\` closely enough for the
@@ -1164,11 +1396,11 @@ const stableForm = (value) => {
  *  readers (\`build.ts\` prerender, \`webDev.ts\` dev SSR, \`start.ts\`). A change to
  *  one of THESE cannot be hot-applied: the server already ran with the old
  *  value. Everything else a page exports is plain client-side data. */
-const serverRelevantExports = ${JSON.stringify(Fn)}
+const serverRelevantExports = ${JSON.stringify(tr)}
 
 /** Name → the server step that already consumed it, so the reload message can
  *  say WHY rather than just WHAT. Injected from the same single source. */
-const serverExportEffect = ${JSON.stringify(Pn)}
+const serverExportEffect = ${JSON.stringify(er)}
 
 /** The reason \`name\` forces a reload, for the console line. */
 export const serverEffectOf = (name) =>
@@ -1211,7 +1443,7 @@ export const routeUpdateNeedsReload = (prevExports, nextExports) => {
 const previousHook = globalThis.__getReactRefreshIgnoredExports
 globalThis.__getReactRefreshIgnoredExports = (args) =>
   ignoredExports.get(args.id) ?? previousHook?.(args) ?? []
-`, Hn = (e) => `
+`, cr = (e) => `
 if (import.meta.hot) {
   // Self-import to read our OWN exports, the same technique the react plugin
   // uses; the namespace is only complete after evaluation, hence the promise.
@@ -1238,57 +1470,57 @@ import {
   registerRouteModule as __voltro_registerRouteModule,
   routeUpdateNeedsReload as __voltro_routeUpdateNeedsReload,
   serverEffectOf as __voltro_serverEffect,
-} from '${Rn}'
-`, Un = (e) => e.replace(/\\/g, "/"), Wn = (e, t) => {
-	let [i = "", a] = Un(e).split("?");
-	if (!i.endsWith(".tsx") || a !== void 0 && Bn.test(a)) return !1;
-	let o = Un(t).replace(/\/$/, "");
+} from '${ir}'
+`, lr = (e) => e.replace(/\\/g, "/"), ur = (e, t) => {
+	let [i = "", a] = lr(e).split("?");
+	if (!i.endsWith(".tsx") || a !== void 0 && or.test(a)) return !1;
+	let o = lr(t).replace(/\/$/, "");
 	return i.startsWith(`${o}/`) ? r.test(i) || n.has(i.slice(i.lastIndexOf("/") + 1)) : !1;
-}, Gn = (e, t, n) => Wn(t, n) ? `${e}${Hn(Un(t).split("?")[0] ?? t)}` : null, Kn = (e) => ({
+}, dr = (e, t, n) => ur(t, n) ? `${e}${cr(lr(t).split("?")[0] ?? t)}` : null, fr = (e) => ({
 	name: "voltro:route-fast-refresh",
 	enforce: "pre",
-	resolveId: (e) => e === "virtual:voltro-route-refresh" ? zn : void 0,
-	load: (e) => e === zn ? Vn() : void 0,
+	resolveId: (e) => e === "virtual:voltro-route-refresh" ? ar : void 0,
+	load: (e) => e === ar ? sr() : void 0,
 	transform: (t, n, r) => {
 		if (r?.ssr === !0) return null;
-		let i = Gn(t, n, e);
+		let i = dr(t, n, e);
 		return i === null ? null : {
 			code: i,
 			map: null
 		};
 	}
-}), qn = [
+}), pr = [
 	"static",
 	"spa",
 	"ssr",
 	"isr"
-], Jn = (e) => typeof e == "string" && qn.includes(e), Yn = qn.map((e) => `'${e}'`).join(" | "), Xn = (e, t) => `[voltro] ${e}: unknown renderMode '${t}'.\n  Valid values: ${Yn}.${t === "client" || t === "csr" || t === "browser" ? "\n  A page that renders only in the browser is 'spa': it is skipped by the prerender and mounts on the client. If its route has a layout, that layout still renders server-side as an SSR shell." : t === "server" || t === "dynamic" ? "\n  A page rendered per request is 'ssr'." : t === "ssg" || t === "prerender" ? "\n  A page rendered once at build time is 'static' (the default)." : ""}`, Zn = class extends Error {
+], mr = (e) => typeof e == "string" && pr.includes(e), hr = pr.map((e) => `'${e}'`).join(" | "), gr = (e, t) => `[voltro] ${e}: unknown renderMode '${t}'.\n  Valid values: ${hr}.${t === "client" || t === "csr" || t === "browser" ? "\n  A page that renders only in the browser is 'spa': it is skipped by the prerender and mounts on the client. If its route has a layout, that layout still renders server-side as an SSR shell." : t === "server" || t === "dynamic" ? "\n  A page rendered per request is 'ssr'." : t === "ssg" || t === "prerender" ? "\n  A page rendered once at build time is 'static' (the default)." : ""}`, _r = class extends Error {
 	page;
 	value;
 	name = "InvalidRenderModeError";
 	constructor(e, t) {
-		super(Xn(e, t)), this.page = e, this.value = t;
+		super(gr(e, t)), this.page = e, this.value = t;
 	}
-}, Qn = (e, t = "<page>") => {
+}, vr = (e, t = "<page>") => {
 	if (e.renderMode !== void 0 && e.renderMode !== null) {
-		if (!Jn(e.renderMode)) throw new Zn(t, String(e.renderMode));
+		if (!mr(e.renderMode)) throw new _r(t, String(e.renderMode));
 		return e.renderMode;
 	}
 	return e.dynamic === "force-dynamic" ? "ssr" : (e.dynamic, "static");
-}, $n = (e, t = "<page>") => ({
-	renderMode: Qn(e, t),
+}, yr = (e, t = "<page>") => ({
+	renderMode: vr(e, t),
 	tenantAware: e.tenantAware === !0,
-	revalidateMs: ct(e.revalidate),
-	staleWhileRevalidateMs: ct(e.staleWhileRevalidate) ?? 0,
+	revalidateMs: lt(e.revalidate),
+	staleWhileRevalidateMs: lt(e.staleWhileRevalidate) ?? 0,
 	cacheInvalidatesOn: Array.isArray(e.cacheInvalidatesOn) ? e.cacheInvalidatesOn : [],
 	interactive: e.interactive ?? "full",
 	hasLoader: typeof e.loader == "function",
 	hasMeta: e.meta != null,
 	hasGetStaticPaths: typeof e.getStaticPaths == "function"
-}), er = /export\s+const\s+renderMode\s*(?::[^=]+)?=\s*['"]([^'"]*)['"]/, tr = (e) => er.exec(e)?.[1] ?? null, nr = /export\s*\{([^}]*)\}\s*from\s*['"]([^'"]+)['"]/g, rr = (e) => {
-	nr.lastIndex = 0;
+}), br = /export\s+const\s+renderMode\s*(?::[^=]+)?=\s*['"]([^'"]*)['"]/, xr = (e) => br.exec(e)?.[1] ?? null, Sr = /export\s*\{([^}]*)\}\s*from\s*['"]([^'"]+)['"]/g, Cr = (e) => {
+	Sr.lastIndex = 0;
 	let t;
-	for (; (t = nr.exec(e)) !== null;) {
+	for (; (t = Sr.exec(e)) !== null;) {
 		let e = t[2];
 		if (e.startsWith(".")) for (let n of t[1].split(",")) {
 			let t = n.lastIndexOf(" as ");
@@ -1296,16 +1528,16 @@ import {
 		}
 	}
 	return null;
-}, ir = /export\s*\{([^}]*)\}/g, ar = (e) => {
+}, wr = /export\s*\{([^}]*)\}/g, Tr = (e) => {
 	if (/export\s+default\b/.test(e)) return !0;
-	ir.lastIndex = 0;
+	wr.lastIndex = 0;
 	let t;
-	for (; (t = ir.exec(e)) !== null;) for (let e of t[1].split(",")) {
+	for (; (t = wr.exec(e)) !== null;) for (let e of t[1].split(",")) {
 		let t = e.lastIndexOf(" as ");
 		if ((t === -1 ? e : e.slice(t + 4)).trim() === "default") return !0;
 	}
 	return !1;
-}, or = async (e, t) => {
+}, Er = async (e, t) => {
 	let n = (await Promise.all(t.map(async (t) => {
 		let n;
 		try {
@@ -1313,33 +1545,33 @@ import {
 		} catch {
 			return null;
 		}
-		let r = tr(n);
-		return r !== null && !Jn(r) ? Xn(p("src", "pages", t.file), r) : ar(n) ? null : `${p("src", "pages", t.file)} is a route (a \`page.tsx\` under src/pages/) but exports no default.\n\n  A page's default export IS its component — the router has nothing to render without it,\n  and the failure would otherwise surface only in \`voltro build\`'s prerender as\n  "SSR received a descriptor with no Component", long after the file was written.\n\n  Fix: \`export default function Page() { … }\`, or re-export another page's component\n  (\`export { default } from '../page'\`). If this file is NOT a route, rename it —\n  only the reserved names route, and anything else under src/pages/ is ordinary code\n  that may live beside the page that uses it.`;
+		let r = xr(n);
+		return r !== null && !mr(r) ? gr(p("src", "pages", t.file), r) : Tr(n) ? null : `${p("src", "pages", t.file)} is a route (a \`page.tsx\` under src/pages/) but exports no default.\n\n  A page's default export IS its component — the router has nothing to render without it,\n  and the failure would otherwise surface only in \`voltro build\`'s prerender as\n  "SSR received a descriptor with no Component", long after the file was written.\n\n  Fix: \`export default function Page() { … }\`, or re-export another page's component\n  (\`export { default } from '../page'\`). If this file is NOT a route, rename it —\n  only the reserved names route, and anything else under src/pages/ is ordinary code\n  that may live beside the page that uses it.`;
 	}))).filter((e) => e !== null);
 	if (n.length !== 0) throw Error(n.join("\n\n"));
-}, X = p(F(), ".voltro", "logs"), sr = () => {
+}, Y = p(L(), ".voltro", "logs"), Dr = () => {
 	let e = Number(process.env.VOLTRO_LOG_FILE_TTL_MS);
 	return Number.isFinite(e) && e > 0 ? e : 3600 * 1e3;
-}, cr = !1, lr = () => {
-	if (cr) return;
-	cr = !0;
-	let e = Date.now() - sr(), t = [];
+}, Or = !1, kr = () => {
+	if (Or) return;
+	Or = !0;
+	let e = Date.now() - Dr(), t = [];
 	try {
-		t = k(X);
+		t = A(Y);
 	} catch {
 		return;
 	}
 	for (let n of t) {
 		if (!n.endsWith(".log")) continue;
-		let t = p(X, n);
+		let t = p(Y, n);
 		try {
-			A(t).mtimeMs < e && j(t);
+			j(t).mtimeMs < e && M(t);
 		} catch {}
 	}
-}, ur = (e) => e.replace(/[^a-zA-Z0-9._-]/g, "_").slice(0, 80), dr = (e, t) => p(X, `${ur(e)}-${t}.log`), fr = (e) => {
-	let t = ur(e), n = [];
+}, Ar = (e) => e.replace(/[^a-zA-Z0-9._-]/g, "_").slice(0, 80), jr = (e, t) => p(Y, `${Ar(e)}-${t}.log`), Mr = (e) => {
+	let t = Ar(e), n = [];
 	try {
-		n = k(X);
+		n = A(Y);
 	} catch {
 		return;
 	}
@@ -1347,19 +1579,19 @@ import {
 	if (r.length === 0) return;
 	let i, a = -1;
 	for (let e of r) {
-		let t = p(X, e);
+		let t = p(Y, e);
 		try {
-			let e = A(t);
+			let e = j(t);
 			e.mtimeMs > a && (a = e.mtimeMs, i = t);
 		} catch {}
 	}
 	return i;
-}, pr = (e) => {
+}, Nr = (e) => {
 	try {
-		E(X, { recursive: !0 });
+		E(Y, { recursive: !0 });
 	} catch {}
-	lr();
-	let t = dr(e, process.pid), n = D(t, "w"), r = (e) => {
+	kr();
+	let t = jr(e, process.pid), n = D(t, "w"), r = (e) => {
 		let t = {
 			ts: e.ts.getTime(),
 			level: e.level,
@@ -1382,7 +1614,7 @@ import {
 		}
 	}, i = !1, a = x((e) => {
 		if (!i) try {
-			M(n, r(e));
+			P(n, r(e));
 		} catch {}
 	}), o = () => {
 		if (!i) {
@@ -1400,7 +1632,7 @@ import {
 			a(), o(), process.off("exit", o), process.off("uncaughtException", s), process.off("unhandledRejection", s);
 		}
 	};
-}, mr = async (e, t) => {
+}, Pr = async (e, t) => {
 	let n;
 	try {
 		n = await O.readFile(e, "utf8");
@@ -1414,11 +1646,11 @@ import {
 		i.push(t);
 	} catch {}
 	return t?.max !== void 0 && i.length > t.max ? i.slice(i.length - t.max) : i;
-}, hr = S({ scope: "voltro:dashboard" }), gr = I(import.meta.url), _r = 5179, vr = (e) => {
+}, Fr = S({ scope: "voltro:dashboard" }), Ir = R(import.meta.url), Lr = 5179, Rr = (e) => {
 	let t = process.env.VOLTRO_DASHBOARD_PATH;
 	if (t && T(p(h(t), "app.config.ts"))) return h(t);
 	try {
-		let e = d(gr.resolve("@voltro/dashboard/package.json"));
+		let e = d(Ir.resolve("@voltro/dashboard/package.json"));
 		if (T(p(e, "app.config.ts"))) return e;
 	} catch {}
 	let n = p("voltro-devtools", "apps", "dashboard"), r = h(e);
@@ -1430,7 +1662,7 @@ import {
 		r = t;
 	}
 	return null;
-}, yr = "VOLTRO_IS_DASHBOARD", br = (e, t = "127.0.0.1", n = 250) => new Promise((r) => {
+}, zr = "VOLTRO_IS_DASHBOARD", Br = (e, t = "127.0.0.1", n = 250) => new Promise((r) => {
 	let i = pe({
 		port: e,
 		host: t
@@ -1438,45 +1670,45 @@ import {
 		a || (a = !0, i.destroy(), r(e));
 	};
 	i.once("connect", () => o(!0)), i.once("error", () => o(!1)), setTimeout(() => o(!1), n);
-}), xr = () => !!(process.env.VOLTRO_DASHBOARD === "off" || process.argv.includes("--disable-dashboard")), Sr = () => process.env[yr] === "1", Cr = () => process.stdout.isTTY === !0, wr = p(F(), ".voltro", "dashboard-launch.lock"), Tr = 1e4, Er = async () => {
+}), Vr = () => !!(process.env.VOLTRO_DASHBOARD === "off" || process.argv.includes("--disable-dashboard")), Hr = () => process.env[zr] === "1", Ur = () => process.stdout.isTTY === !0, Wr = p(L(), ".voltro", "dashboard-launch.lock"), Gr = 1e4, Kr = async () => {
 	try {
-		await O.mkdir(d(wr), { recursive: !0 });
-		let e = await O.open(wr, "wx");
+		await O.mkdir(d(Wr), { recursive: !0 });
+		let e = await O.open(Wr, "wx");
 		return await e.write(`${process.pid}\n${Date.now()}\n`), await e.close(), !0;
 	} catch {
 		try {
-			let e = await O.stat(wr);
-			if (Date.now() - e.mtimeMs > Tr) return await O.unlink(wr).catch(() => void 0), Er();
+			let e = await O.stat(Wr);
+			if (Date.now() - e.mtimeMs > Gr) return await O.unlink(Wr).catch(() => void 0), Kr();
 		} catch {}
 		return !1;
 	}
-}, Dr = async () => {
+}, qr = async () => {
 	try {
-		await O.unlink(wr);
+		await O.unlink(Wr);
 	} catch {}
-}, Or = async (e) => {
+}, Jr = async (e) => {
 	let t = e.port ?? 5179;
-	if (xr()) return {
+	if (Vr()) return {
 		status: "skipped",
 		reason: "disabled by flag/env",
 		port: t
 	};
-	if (Sr()) return {
+	if (Hr()) return {
 		status: "skipped",
 		reason: "this process IS the dashboard",
 		port: t
 	};
-	if (!Cr()) return {
+	if (!Ur()) return {
 		status: "skipped",
 		reason: "stdout is not a TTY (CI/smoke)",
 		port: t
 	};
-	if (!await Er()) return {
+	if (!await Kr()) return {
 		status: "skipped",
 		reason: "another voltro process is currently launching the dashboard",
 		port: t
 	};
-	if (await br(t)) return await Dr(), {
+	if (await Br(t)) return await qr(), {
 		status: "already-running",
 		port: t
 	};
@@ -1493,7 +1725,7 @@ import {
 		stdio: "ignore",
 		env: {
 			...process.env,
-			[yr]: "1",
+			[zr]: "1",
 			VOLTRO_DASHBOARD_PORT: String(t)
 		}
 	});
@@ -1501,22 +1733,22 @@ import {
 		if (a.exitCode === null && a.signalCode === null) try {
 			a.kill("SIGTERM");
 		} catch {}
-	}), hr.info(`auto-launching dashboard at http://localhost:${t}`, {
+	}), Fr.info(`auto-launching dashboard at http://localhost:${t}`, {
 		port: t,
 		mode: i,
 		prebuilt: r
-	}), r || hr.debug("no pre-built dashboard — running `voltro dev`. Build with `cd voltro-devtools && pnpm build` for a fast prod boot."), hr.debug("disable via --disable-dashboard or VOLTRO_DASHBOARD=off"), setTimeout(() => {
-		Dr();
+	}), r || Fr.debug("no pre-built dashboard — running `voltro dev`. Build with `cd voltro-devtools && pnpm build` for a fast prod boot."), Fr.debug("disable via --disable-dashboard or VOLTRO_DASHBOARD=off"), setTimeout(() => {
+		qr();
 	}, 4e3).unref(), {
 		status: "launched",
 		port: t
 	};
-}, kr = class extends Error {
+}, Yr = class extends Error {
 	_voltroDeferral = !0;
 	constructor(e) {
 		super(e), this.name = "DeferralNotSupportedError";
 	}
-}, Ar = (e) => typeof e == "object" && !!e && e._voltroDeferral === !0, jr = (e) => {
+}, Xr = (e) => typeof e == "object" && !!e && e._voltroDeferral === !0, Zr = (e) => {
 	if (!(e instanceof Error)) return;
 	let t = e._voltroControl;
 	if (t === "redirect") {
@@ -1538,7 +1770,7 @@ import {
 		},
 		body: "not found"
 	};
-}, Mr = (e) => {
+}, Qr = (e) => {
 	let { helpers: t } = e, n = t.prepareDeferredLoaderData(e.loaderData, "page"), r = {}, i = {}, a = {};
 	for (let [n, o] of Object.entries(e.segmentLoaderData)) {
 		let e = Number(n), s = t.prepareDeferredLoaderData(o, e);
@@ -1553,7 +1785,7 @@ import {
 			...e.layoutShell ? { layoutShell: e.layoutShell } : {}
 		});
 	} catch (e) {
-		throw new kr(e instanceof Error ? e.message : String(e));
+		throw new Yr(e instanceof Error ? e.message : String(e));
 	}
 	return {
 		loaderData: n.renderData,
@@ -1569,8 +1801,8 @@ import {
 			...Object.keys(a).length > 0 ? { deferredSegmentIds: a } : {}
 		}
 	};
-}, Nr = (e) => {
-	let { helpers: t, renderInput: n } = e, r = Mr({
+}, $r = (e) => {
+	let { helpers: t, renderInput: n } = e, r = Qr({
 		helpers: t,
 		page: e.page,
 		pathname: n.pathname,
@@ -1591,19 +1823,19 @@ import {
 		stateScript: t.renderRouterStateScript(r.stateInput),
 		hasDeferred: r.hasDeferred
 	};
-}, Pr = (e) => {
+}, ei = (e) => {
 	let { html: t, meta: n } = e.helpers.renderPageToHtml(e.prepared.renderInput);
 	return {
 		body: t,
 		meta: n
 	};
-}, Fr = (e) => [
+}, ti = (e) => [
 	...e.extra ?? [],
 	e.helpers.renderMetaToHtml(e.meta),
 	`<meta name="voltro-interactive" content="${e.interactive}" />`,
 	...e.prepared.hasDeferred ? [e.helpers.renderDeferredRegistryScript()] : [],
 	e.prepared.stateScript
-].filter((e) => e.length > 0).join("\n    "), Ir = (e) => {
+].filter((e) => e.length > 0).join("\n    "), ni = (e) => {
 	let t = e.indexOf("?");
 	return t === -1 ? {
 		pathname: e || "/",
@@ -1612,53 +1844,90 @@ import {
 		pathname: e.slice(0, t) || "/",
 		search: e.slice(t)
 	};
-}, Lr = /Could not find required `intl` object/, Rr = (e) => [
+}, ri = /Could not find required `intl` object/, ii = "__voltro_i18n_instances__", ai = (e = globalThis) => {
+	try {
+		let t = e[ii]?.records;
+		return t === void 0 || t.length === 0 ? void 0 : {
+			instances: t.length,
+			reactIntlCopies: new Set(t.map((e) => e.intlProvider)).size,
+			files: [...new Set(t.map((e) => e.file))]
+		};
+	} catch {
+		return;
+	}
+}, oi = (e, t) => [
 	"",
 	"── voltro diagnosis ───────────────────────────────────────────────────",
-	`${e} DID wrap this render in <I18nProvider> — the framework`,
-	"resolved a locale for this request and supplied the provider. You are",
-	"seeing this error anyway, which leaves one cause:",
+	`${e} DID wrap this render in <I18nProvider>, and this process`,
+	`holds ${t.instances} live copies of @voltro/i18n bound to`,
+	`${t.reactIntlCopies} distinct react-intl instances.`,
 	"",
-	"  TWO PHYSICAL COPIES OF react-intl (or of @voltro/i18n, which owns it).",
+	"  THAT is the cause. A React context is identified by object identity,",
+	"  so the provider built from one copy is invisible to a `useT()` from the",
+	"  other, and the error is identical to having no provider at all.",
 	"",
-	"A React context is identified by object identity. The provider built from",
-	"one copy is invisible to a `useT()` / `useIntl()` from the other, and the",
-	"error is identical to having no provider at all.",
+	"  Loaded from:",
+	...t.files.map((e) => `    - ${e}`),
 	"",
-	"Check it:",
+	"  NOTE: `pnpm ls` will very likely show ONE version. It enumerates",
+	"  versions on disk; this counts instances in the running process, and one",
+	"  file loaded down two paths is two instances.",
+	"───────────────────────────────────────────────────────────────────────"
+].join("\n"), si = (e, t) => [
+	"",
+	"── voltro diagnosis ───────────────────────────────────────────────────",
+	`${e} DID wrap this render in <I18nProvider>, and this process`,
+	`holds exactly ONE @voltro/i18n bound to ONE react-intl (${t.instances}/${t.reactIntlCopies}, from ${t.files[0] ?? "unknown"}).`,
+	"",
+	"  So neither of the two known causes applies, and this IS a framework",
+	"  bug — report it with this block attached.",
 	"",
-	"    pnpm ls -r --depth 10 @voltro/i18n react-intl",
+	"  One thing to check first, because it is the remaining non-framework",
+	"  cause and it is in YOUR code: a provider built from react-intl",
+	"  DIRECTLY (`import { IntlProvider } from \"react-intl\"`) rather than from",
+	"  @voltro/i18n. Vite bundles react-intl for modules it transforms, so a",
+	"  direct import can land on a second copy that this count does not see —",
+	"  it counts what @voltro/i18n is bound to.",
+	"───────────────────────────────────────────────────────────────────────"
+].join("\n"), ci = (e) => [
+	"",
+	"── voltro diagnosis ───────────────────────────────────────────────────",
+	`${e} DID wrap this render in <I18nProvider> — the framework`,
+	"resolved a locale for this request and supplied the provider, so \"no",
+	"provider\" is excluded.",
 	"",
-	"More than one version of either, anywhere in the workspace, is the cause.",
-	"It usually means one package.json was left behind on an upgrade — the app",
-	"still builds and every other test still passes.",
+	"  The instance count is unavailable (@voltro/i18n did not register), so",
+	"  the remaining cause cannot be confirmed from here. It is almost always",
+	"  TWO LIVE COPIES of react-intl or @voltro/i18n — a React context is an",
+	"  object identity, and a provider from one copy is invisible to a hook",
+	"  from the other.",
 	"",
-	"If both resolve to exactly one version, this diagnosis is wrong and the",
-	"framework is at fault. Report it with that output attached.",
+	"  Do NOT use `pnpm ls` to rule that out: it lists versions on disk, and",
+	"  the duplication here is of module instances in one process.",
 	"───────────────────────────────────────────────────────────────────────"
-].join("\n"), zr = (e, t, n) => {
+].join("\n"), li = (e, t, n, r = ai()) => {
 	if (!t) return;
-	let r = String(e?.message ?? e);
-	return Lr.test(r) ? Rr(n) : void 0;
-}, Br = "<div id=\"root\"></div>", Vr = "<div id=\"root\">", Hr = "</div>", Ur = /<script\b[^>]*\btype=["']module["'][^>]*><\/script>[ \t]*\n?/gi, Wr = /\bsrc=["']([^"']+)["']/i, Gr = /<script(?![^>]*\basync\b)([^>]*\btype=["']module["'][^>]*)>/gi, Kr = (e) => {
-	let t = e.keepScriptInHead ?? ((e) => e.startsWith("/@")), n = [], r = e.shell.replace(Ur, (e) => {
-		let r = Wr.exec(e)?.[1];
+	let i = String(e?.message ?? e);
+	if (ri.test(i)) return r === void 0 ? ci(n) : r.reactIntlCopies > 1 || r.instances > 1 ? oi(n, r) : si(n, r);
+}, ui = "<div id=\"root\"></div>", di = "<div id=\"root\">", fi = "</div>", pi = /<script\b[^>]*\btype=["']module["'][^>]*><\/script>[ \t]*\n?/gi, mi = /\bsrc=["']([^"']+)["']/i, hi = /<script(?![^>]*\basync\b)([^>]*\btype=["']module["'][^>]*)>/gi, gi = (e) => {
+	let t = e.keepScriptInHead ?? ((e) => e.startsWith("/@")), n = [], r = e.shell.replace(pi, (e) => {
+		let r = mi.exec(e)?.[1];
 		return r === void 0 || t(r) ? e : (n.push(r), "");
 	});
-	e.inlineModuleScriptsAsync && (r = r.replace(Gr, "<script async$1>"));
-	let i = r.indexOf(Br);
-	if (i === -1) throw Error(`[voltro] the generated shell has no \`${Br}\` element, so a streamed response cannot be split around the page body. This is a framework bug unless the app overrode \`.framework/index.html\` by hand.`);
+	e.inlineModuleScriptsAsync && (r = r.replace(hi, "<script async$1>"));
+	let i = r.indexOf(ui);
+	if (i === -1) throw Error(`[voltro] the generated shell has no \`${ui}\` element, so a streamed response cannot be split around the page body. This is a framework bug unless the app overrode \`.framework/index.html\` by hand.`);
 	return {
-		head: `${r.slice(0, i)}${Vr}`,
-		tail: `${Hr}${r.slice(i + 21)}`,
+		head: `${r.slice(0, i)}${di}`,
+		tail: `${fi}${r.slice(i + 21)}`,
 		bootstrapModules: n
 	};
-}, qr = (e, t) => (/<title>/i.test(t) ? e.replace(/[^\S\n]*<title>[\s\S]*?<\/title>\n?/i, "") : e).replace("</head>", `    ${t}\n  </head>`), Jr = (e) => qr(e.head, e.headInjection).replace(/<html(\s+lang="[^"]*")?/i, `<html lang="${e.htmlLang}"`), Yr = (e) => {
+}, _i = (e, t) => (/<title>/i.test(t) ? e.replace(/[^\S\n]*<title>[\s\S]*?<\/title>\n?/i, "") : e).replace("</head>", `    ${t}\n  </head>`), vi = (e) => _i(e.head, e.headInjection).replace(/<html(\s+lang="[^"]*")?/i, `<html lang="${e.htmlLang}"`), yi = (e) => {
 	let { res: t, shell: n, htmlLang: 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(Jr({
+		t.flushHeaders?.(), t.write(vi({
 			head: n.head,
 			headInjection: i(a.meta),
 			htmlLang: r
@@ -1688,16 +1957,16 @@ import {
 		return;
 	}
 	c();
-}, Xr = (e) => Array.isArray(e.preload) && e.preload.length > 0, Zr = (e, t) => typeof e == "string" ? {
+}, bi = (e) => Array.isArray(e.preload) && e.preload.length > 0, xi = (e, t) => typeof e == "string" ? {
 	tag: e,
 	input: {}
 } : {
 	tag: e.tag,
 	input: e.input?.(t) ?? {}
-}, Qr = async (e) => {
+}, Si = async (e) => {
 	let { pageMod: t, params: n, query: r, apiName: i, seed: a, onError: o } = e;
-	if (Xr(t) && !(r === void 0 || i === void 0)) for (let e of t.preload) {
-		let { tag: t, input: s } = Zr(e, n);
+	if (bi(t) && !(r === void 0 || i === void 0)) for (let e of t.preload) {
+		let { tag: t, input: s } = xi(e, n);
 		try {
 			a(i, t, s, await r(t, s));
 		} catch (e) {
@@ -1707,14 +1976,14 @@ import {
 			}, e);
 		}
 	}
-}, Z = S({ scope: "voltro:dev:web" }), $r = S({ scope: "vite" }), ei = await (async () => {
+}, X = S({ scope: "voltro:dev:web" }), Ci = S({ scope: "vite" }), wi = await (async () => {
 	try {
 		let e = p(d(g(import.meta.url)), "..", "package.json"), t = await O.readFile(e, "utf8");
 		return JSON.parse(t).version ?? "0.0.0";
 	} catch {
 		return "0.0.0";
 	}
-})(), ti = async () => {
+})(), Ti = async () => {
 	try {
 		let e = d(g(import.meta.url)), t = h(e, "..", "..", "devtools");
 		if (T(p(t, "package.json"))) return t;
@@ -1723,7 +1992,7 @@ import {
 	} catch {
 		return null;
 	}
-}, ni = (e, t) => e.disableDevtools || !t ? [] : [
+}, Ei = (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",
@@ -1733,12 +2002,12 @@ import {
 	"  await import('@voltro/devtools/styles.css')",
 	"  Devtools = (await import('@voltro/devtools')).VoltroDevtools",
 	"}"
-], ri = (e, t) => e.disableDevtools || !t ? [] : ["  ...(Devtools ? { Devtools } : {}),"], ii = (e) => e.sentry ? ["import { initSentryBrowser } from '@voltro/plugin-sentry/web'"] : [], ai = (e) => e.sentry ? [
+], Di = (e, t) => e.disableDevtools || !t ? [] : ["  ...(Devtools ? { Devtools } : {}),"], Oi = (e) => e.sentry ? ["import { initSentryBrowser } from '@voltro/plugin-sentry/web'"] : [], ki = (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)})`
-] : [], oi = (e) => e.env ? ["import './env.public'"] : [], si = (e) => {
+] : [], Ai = (e) => e.env ? ["import './env.public'"] : [], ji = (e) => {
 	let t = [], n = h(e);
 	for (;;) {
 		T(p(n, "pnpm-workspace.yaml")) && t.push(n);
@@ -1747,14 +2016,14 @@ import {
 		n = e;
 	}
 	return t;
-}, ci = In, li = (e) => {
+}, Mi = nr, Ni = (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]}`;
-}, ui = /export\s+(?:async\s+)?(?:const|function|let|var)\s+loader\b/, di = (e) => e.startsWith("(") && e.endsWith(")"), fi = (e) => e.filter((e) => !di(e)), pi = (e) => {
-	let t = e.replace(r, "").split("/").filter(Boolean).filter((e) => !di(e));
+}, Pi = /export\s+(?:async\s+)?(?:const|function|let|var)\s+loader\b/, Fi = (e) => e.startsWith("(") && e.endsWith(")"), Ii = (e) => e.filter((e) => !Fi(e)), Li = (e) => {
+	let t = e.replace(r, "").split("/").filter(Boolean).filter((e) => !Fi(e));
 	return t.length === 0 ? "/" : "/" + t.join("/");
-}, mi = (e) => `${e.replace(r, "").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`, Q = (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}`, $ = async (e) => {
+}, Ri = (e) => `${e.replace(r, "").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`, Z = (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}`, Q = async (e) => {
 	let t = [], i = [], a = async (e, o) => {
 		let s = [];
 		try {
@@ -1762,17 +2031,17 @@ import {
 		} catch {
 			return;
 		}
-		let c = s.filter((e) => e.isDirectory()).map((e) => e.name).sort(), l = s.filter((e) => e.isFile() && e.name.endsWith(".tsx") && !ci(e.name)).map((e) => e.name).sort(), u = new Set(l), d = o.join("/");
+		let c = s.filter((e) => e.isDirectory()).map((e) => e.name).sort(), l = s.filter((e) => e.isFile() && e.name.endsWith(".tsx") && !Mi(e.name)).map((e) => e.name).sort(), u = new Set(l), d = o.join("/");
 		if (l.some((e) => n.has(e))) {
 			let t = u.has("layout.tsx"), r = !1;
 			if (t) try {
 				let t = await O.readFile(p(e, "layout.tsx"), "utf8");
-				r = ui.test(t);
+				r = Pi.test(t);
 			} catch {}
 			i.push({
 				dir: d,
 				chain: o,
-				contributesToUrl: o.length === 0 || !di(o[o.length - 1]),
+				contributesToUrl: o.length === 0 || !Fi(o[o.length - 1]),
 				hasLayout: t,
 				hasLayoutLoader: r,
 				hasError: u.has("error.tsx"),
@@ -1786,8 +2055,8 @@ import {
 			let n = d ? `${d}/${e}` : e;
 			t.push({
 				file: n,
-				pattern: pi(n),
-				ident: mi(n),
+				pattern: Li(n),
+				ident: Ri(n),
 				dirChain: o
 			});
 		}
@@ -1806,14 +2075,14 @@ import {
 		dirs: s,
 		orphanedSpecials: c
 	};
-}, hi = (e, t) => {
+}, zi = (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;
-}, gi = async (e) => {
+}, Bi = 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) => {
@@ -1836,10 +2105,10 @@ import {
 		})),
 		segmentLoaderData: o
 	};
-}, _i = (e) => {
-	let t = fi(e);
+}, Vi = (e) => {
+	let t = Ii(e);
 	return t.length === 0 ? "" : "/" + t.join("/");
-}, vi = [
+}, Hi = [
 	"// 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>",
@@ -1932,7 +2201,7 @@ import {
 	"    _vdtErrorStart('Build error')",
 	"  })",
 	"}"
-].join("\n"), yi = (e) => {
+].join("\n"), Ui = (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("/");
@@ -1941,8 +2210,8 @@ import {
 		paramNames: t,
 		priority: n
 	};
-}, bi = (e) => e.map((e) => {
-	let { regex: t, paramNames: n, priority: r } = yi(e.pattern);
+}, Wi = (e) => e.map((e) => {
+	let { regex: t, paramNames: n, priority: r } = Ui(e.pattern);
 	return {
 		pattern: e.pattern,
 		file: e.file,
@@ -1951,7 +2220,7 @@ import {
 		paramNames: n,
 		priority: r
 	};
-}).slice().sort((e, t) => e.priority - t.priority), xi = (e, t) => {
+}).slice().sort((e, t) => e.priority - t.priority), Gi = (e, t) => {
 	for (let n of t) {
 		let t = n.regex.exec(e);
 		if (!t) continue;
@@ -1963,7 +2232,7 @@ import {
 		};
 	}
 	return null;
-}, Si = async (e, t) => {
+}, Ki = async (e, t) => {
 	let n = e;
 	for (;;) {
 		let e = p(n, "node_modules", t);
@@ -1977,7 +2246,7 @@ import {
 		if (r === n) return null;
 		n = r;
 	}
-}, Ci = async (e) => {
+}, qi = async (e) => {
 	try {
 		let t = await import(_(p(e, "app.config.ts")).href), n = t.default?.port, r = typeof n == "number" ? n : 4e3, i = t.default?.transport?.wsPath, a = typeof i == "string" && i.startsWith("/") ? i : void 0;
 		return a ? {
@@ -1986,7 +2255,7 @@ import {
 		} : { port: r };
 	} catch {}
 	return { port: 4e3 };
-}, wi = (e, t) => ({
+}, Ji = (e, t) => ({
 	name: e,
 	pkg: t.package,
 	browserWsUrl: t.url,
@@ -1994,7 +2263,7 @@ import {
 	...t.serverUrl ? { serverOrigin: t.serverUrl } : {},
 	...t.headers ? { headers: t.headers } : {},
 	...t.authHeaders ? { hasAuthHeaders: !0 } : {}
-}), Ti = (e, t, n) => {
+}), Yi = (e, t, n) => {
 	let r = t.transport?.wsPath ?? n.wsPath;
 	return {
 		name: e,
@@ -2006,7 +2275,7 @@ import {
 		...t.headers ? { headers: t.headers } : {},
 		...t.authHeaders ? { hasAuthHeaders: !0 } : {}
 	};
-}, Ei = (e) => {
+}, Xi = (e) => {
 	let t = /* @__PURE__ */ new Map();
 	for (let n of e) {
 		if (n.proxyTarget === void 0) continue;
@@ -2014,43 +2283,43 @@ import {
 		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);
 	}
-}, Di = async (e, t) => {
+}, Zi = async (e, t) => {
 	let n = Object.entries(t.apis ?? {}), r = [];
 	for (let [t, i] of n) {
 		if (i.url) {
-			r.push(wi(t, i));
+			r.push(Ji(t, i));
 			continue;
 		}
-		let n = await Si(e, i.package);
+		let n = await Ki(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(Ti(t, i, await Ci(n)));
+		r.push(Yi(t, i, await qi(n)));
 	}
-	return Ei(r), r;
-}, Oi = (e) => {
+	return Xi(r), r;
+}, Qi = (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;
 	}
-}, ki = (e) => `VOLTRO_API_ORIGIN_${e.toUpperCase().replace(/[^A-Z0-9]/g, "_")}`, Ai = (e) => process.env[ki(e)] ?? process.env.VOLTRO_API_ORIGIN, ji = (e, t) => {
+}, $i = (e) => `VOLTRO_API_ORIGIN_${e.toUpperCase().replace(/[^A-Z0-9]/g, "_")}`, ea = (e) => process.env[$i(e)] ?? process.env.VOLTRO_API_ORIGIN, ta = (e, t) => {
 	if (!e) return;
-	let n = Ai(e.name) ?? e.serverOrigin;
+	let n = ea(e.name) ?? e.serverOrigin;
 	if (n) {
-		let e = Oi(n);
+		let e = Qi(n);
 		if (e) return e;
 	}
 	if (t?.allowDevProxy && e.proxyTarget) {
-		let t = Oi(e.proxyTarget);
+		let t = Qi(e.proxyTarget);
 		if (t) return t;
 	}
-	if (!e.proxyTarget && /^wss?:\/\//.test(e.browserWsUrl)) return Oi(e.browserWsUrl);
-}, Mi = (e, t, n) => {
+	if (!e.proxyTarget && /^wss?:\/\//.test(e.browserWsUrl)) return Qi(e.browserWsUrl);
+}, na = (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 ${ki(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 ${$i(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) => {
@@ -2072,7 +2341,7 @@ import {
 			});
 		} 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 ${ki(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 ${$i(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();
@@ -2090,8 +2359,8 @@ import {
 		}
 		if (u) return l;
 	};
-}, Ni = async (e, t, n, r = {}) => {
-	let i = t.title ?? t.name ?? "app", a = t.theme === "dark" ? " class=\"dark\"" : t.theme === "light" ? " class=\"light\"" : "", o = T(p(e, "node_modules", "@voltro", "devtools", "package.json")) || await ti() !== null, s = t.theme === "system" ? [
+}, $ = async (e, t, n, r = {}) => {
+	let i = t.title ?? t.name ?? "app", a = t.theme === "dark" ? " class=\"dark\"" : t.theme === "light" ? " class=\"light\"" : "", o = T(p(e, "node_modules", "@voltro", "devtools", "package.json")) || await Ti() !== null, s = t.theme === "system" ? [
 		"    <script>",
 		"      (function () {",
 		"        var root = document.documentElement",
@@ -2129,9 +2398,9 @@ import {
 		"  </body>",
 		"</html>",
 		""
-	].join("\n"), l = p(e, "src", "pages"), { pages: u, dirs: d, orphanedSpecials: f } = await $(l);
-	await or(l, u);
-	for (let e of f) Z.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.`);
+	].join("\n"), l = p(e, "src", "pages"), { pages: u, dirs: d, orphanedSpecials: f } = await Q(l);
+	await Er(l, u);
+	for (let e of f) X.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) => {
@@ -2142,16 +2411,16 @@ import {
 		let n = u.map((e) => `  ${JSON.stringify(e.pattern)}: () => import('../src/pages/${e.file}'),`), r = [];
 		for (let e of d) {
 			let t = e.dir === "" ? "../src/pages" : `../src/pages/${e.dir}`;
-			e.hasLayout && e.hasLayoutLoader ? r.push(`import * as ${Q(e.dir, "Layout")}Mod from '${t}/layout.tsx'`) : e.hasLayout && r.push(`import ${Q(e.dir, "Layout")}   from '${t}/layout.tsx'`), e.hasError && r.push(`import ${Q(e.dir, "Error")}    from '${t}/error.tsx'`), e.hasPending && r.push(`import ${Q(e.dir, "Pending")}  from '${t}/loading.tsx'`), e.hasNotFound && r.push(`import ${Q(e.dir, "NotFound")} from '${t}/not-found.tsx'`);
+			e.hasLayout && e.hasLayoutLoader ? r.push(`import * as ${Z(e.dir, "Layout")}Mod from '${t}/layout.tsx'`) : e.hasLayout && r.push(`import ${Z(e.dir, "Layout")}   from '${t}/layout.tsx'`), e.hasError && r.push(`import ${Z(e.dir, "Error")}    from '${t}/error.tsx'`), e.hasPending && r.push(`import ${Z(e.dir, "Pending")}  from '${t}/loading.tsx'`), e.hasNotFound && r.push(`import ${Z(e.dir, "NotFound")} from '${t}/not-found.tsx'`);
 		}
 		let i = u.map((e) => {
-			let t = hi(d, e.dirChain).map((e) => {
+			let t = zi(d, 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 = _i(e.chain), n = hi(d, e.chain).map((e) => {
+			let t = Vi(e.chain), n = zi(d, 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      ],` : "";
@@ -2159,23 +2428,23 @@ import {
 		}), s = [], c = [], l = [], f = [], m = [], h = [];
 		for (let e of d) {
 			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}: ${Q(e.dir, "Layout")}Mod.default,`), l.push(`  ${a}: ${Q(e.dir, "Layout")}Mod.loader,`), s.push({
+			e.hasLayout && e.hasLayoutLoader ? (c.push(`  ${a}: ${Z(e.dir, "Layout")}Mod.default,`), l.push(`  ${a}: ${Z(e.dir, "Layout")}Mod.loader,`), s.push({
 				relPath: t,
 				kind: "layout",
 				slotKey: e.dir
-			})) : e.hasLayout && (c.push(`  ${a}: ${Q(e.dir, "Layout")},`), s.push({
+			})) : e.hasLayout && (c.push(`  ${a}: ${Z(e.dir, "Layout")},`), s.push({
 				relPath: t,
 				kind: "layout",
 				slotKey: e.dir
-			})), e.hasError && (f.push(`  ${a}: ${Q(e.dir, "Error")},`), s.push({
+			})), e.hasError && (f.push(`  ${a}: ${Z(e.dir, "Error")},`), s.push({
 				relPath: n,
 				kind: "error",
 				slotKey: e.dir
-			})), e.hasPending && (m.push(`  ${a}: ${Q(e.dir, "Pending")},`), s.push({
+			})), e.hasPending && (m.push(`  ${a}: ${Z(e.dir, "Pending")},`), s.push({
 				relPath: r,
 				kind: "pending",
 				slotKey: e.dir
-			})), e.hasNotFound && (h.push(`  ${a}: ${Q(e.dir, "NotFound")},`), s.push({
+			})), e.hasNotFound && (h.push(`  ${a}: ${Z(e.dir, "NotFound")},`), s.push({
 				relPath: i,
 				kind: "notFound",
 				slotKey: e.dir
@@ -2190,7 +2459,7 @@ import {
 			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 }`;
 		}), C = t.locales ?? [], w = C.length > 0 && C.every((t) => T(p(e, "src", "locales", `${t}.ts`)) || T(p(e, "src", "locales", `${t}.tsx`))), E = w, D = t.defaultLocale ?? C[0] ?? "en";
-		if (C.length > 0 && !w && Z.info(`i18n: locales [${C.join(", ")}] declared with no src/locales/<code>.ts — using them for <html lang> and the resolved locale only. Add the catalogs to get <I18nProvider> wired, or keep your own i18n stack.`), C.length > 0 && !C.includes(D)) throw Error(`[voltro dev] app.config.ts: defaultLocale '${D}' must be one of locales [${C.join(", ")}]`);
+		if (C.length > 0 && !w && X.info(`i18n: locales [${C.join(", ")}] declared with no src/locales/<code>.ts — using them for <html lang> and the resolved locale only. Add the catalogs to get <I18nProvider> wired, or keep your own i18n stack.`), C.length > 0 && !C.includes(D)) throw Error(`[voltro dev] app.config.ts: defaultLocale '${D}' must be one of locales [${C.join(", ")}]`);
 		let O = E ? [
 			"import { I18nProvider } from '@voltro/i18n'",
 			"import { resolveLocale } from '@voltro/i18n/server'",
@@ -2407,14 +2676,14 @@ import {
 			"// resolved apis map. Side-effect only — no local component definitions —",
 			"// so downstream invalidations (user page edits) terminate at app.tsx.",
 			"",
-			...oi(t),
+			...Ai(t),
 			"import { mount } from '@voltro/web'",
 			...g,
 			"import { App } from './app'",
 			"import { preloadCurrentRoute } from './routeTable'",
-			...ii(t),
-			...ni(t, o),
-			...ai(t),
+			...Oi(t),
+			...Ei(t, o),
+			...ki(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",
@@ -2431,10 +2700,10 @@ import {
 			"  apis: {",
 			..._,
 			"  },",
-			...ri(t, o),
+			...Di(t, o),
 			"})",
 			"",
-			vi
+			Hi
 		].join("\n");
 	} else v = "", y = "", b = [
 		"// GENERATED BY `voltro dev` — do not edit; will be overwritten on next boot.",
@@ -2442,25 +2711,25 @@ import {
 		"// and calls mount(). Side-effect only, no component definitions, so the",
 		"// user's component file remains the Fast Refresh boundary.",
 		"",
-		...oi(t),
+		...Ai(t),
 		"import { mount } from '@voltro/web'",
 		...g,
 		"import App from '../src/App'",
-		...ii(t),
-		...ni(t, o),
-		...ai(t),
+		...Oi(t),
+		...Ei(t, o),
+		...ki(t),
 		"",
 		"mount(App, {",
 		"  apis: {",
 		..._,
 		"  },",
-		...ri(t, o),
+		...Di(t, o),
 		"})",
 		"",
-		vi
+		Hi
 	].join("\n");
 	let x = p(e, ".framework");
-	await O.mkdir(x, { recursive: !0 }), t.env ? await nt(x, r) : await O.rm(p(x, "env.public.ts"), { force: !0 }), await O.writeFile(p(x, "index.html"), c, "utf8"), await O.writeFile(p(x, "main.tsx"), b, "utf8"), v ? (await O.writeFile(p(x, "app.tsx"), v, "utf8"), await O.writeFile(p(x, "routeTable.ts"), y, "utf8")) : (await O.rm(p(x, "app.tsx"), { force: !0 }), await O.rm(p(x, "routeTable.ts"), { force: !0 }));
+	await O.mkdir(x, { recursive: !0 }), t.env ? await rt(x, r) : await O.rm(p(x, "env.public.ts"), { force: !0 }), await O.writeFile(p(x, "index.html"), c, "utf8"), await O.writeFile(p(x, "main.tsx"), b, "utf8"), v ? (await O.writeFile(p(x, "app.tsx"), v, "utf8"), await O.writeFile(p(x, "routeTable.ts"), y, "utf8")) : (await O.rm(p(x, "app.tsx"), { force: !0 }), await O.rm(p(x, "routeTable.ts"), { force: !0 }));
 	let S = p(e, ".gitignore"), C = "";
 	try {
 		C = await O.readFile(S, "utf8");
@@ -2471,65 +2740,65 @@ import {
 		try {
 			await O.appendFile(S, `${e}${D.join("\n")}\n`, "utf8");
 		} catch (e) {
-			Z.warn(`could not add ${D.join(", ")} to ${S} — add it by hand so the generated directory stays out of git. The build is unaffected.`, { reason: e?.message ?? String(e) });
+			X.warn(`could not add ${D.join(", ")} to ${S} — add it by hand so the generated directory stays out of git. The build is unaffected.`, { reason: e?.message ?? String(e) });
 		}
 	}
-}, Pi = async (e, t) => {
+}, ra = async (e, t) => {
 	try {
 		let n = p(d(e), "project.json");
 		if (!T(n)) return;
 		let r = await O.readFile(n, "utf8"), i = JSON.parse(r).apps ?? {}, a = e.split("/").filter(Boolean).pop() ?? "", o = [];
 		for (let [e, n] of Object.entries(i)) e !== a && n.port === t && o.push(e);
 		if (o.length === 0) return;
-		Z.warn("sibling app(s) claim the same port — only one boots", {
+		X.warn("sibling app(s) claim the same port — only one boots", {
 			port: t,
 			conflicts: o,
 			projectJson: n
 		});
 	} catch {}
-}, Fi = (e) => p(e, ".framework", "dist", "server", "appConfig.js"), Ii = async (e) => {
-	let t = Fi(e), n = T(t) ? t : p(e, "app.config.ts");
+}, ia = (e) => p(e, ".framework", "dist", "server", "appConfig.js"), aa = async (e, t = {}) => {
+	let n = ia(e), r = t.preferSource !== !0 && T(n) ? n : p(e, "app.config.ts");
 	try {
-		let e = (await import(_(n).href)).default;
+		let e = (await import(_(r).href)).default;
 		return typeof e == "object" && e && "type" in e && e.type === "web" ? e : null;
 	} catch {
 		return null;
 	}
-}, Li = async (e) => {
-	let t = await Ii(e);
+}, oa = async (e) => {
+	let t = await aa(e, { preferSource: !0 });
 	if (!t) return {
 		ran: !1,
 		exitCode: 0
 	};
-	Nn();
-	let n = qt();
-	fn(n), Z.info("booting voltro dev (web)", { app: t.name ?? "(unnamed)" });
-	let r = await Di(e, t);
-	for (let e of r) Z.info("api wired", {
+	$n();
+	let n = mn();
+	Mn(n), X.info("booting voltro dev (web)", { app: t.name ?? "(unnamed)" }), Lt(e, X);
+	let r = await Zi(e, t);
+	for (let e of r) X.info("api wired", {
 		name: e.name,
 		pkg: e.pkg,
 		...e.proxyTarget ? { proxyTo: e.proxyTarget } : { directWs: e.browserWsUrl }
 	});
-	Me(e).then((e) => {
+	Ne(e).then((e) => {
 		for (let t of e.files) if (t.action === "created") {
 			let e = t.path.split("/").pop() ?? t.path;
-			Z.info(`${e} seeded`, { path: t.path });
+			X.info(`${e} seeded`, { path: t.path });
 		}
 	}).catch(() => {});
-	let { resolved: d } = await rt({
+	let { resolved: d } = await it({
 		rawEnv: t.env,
 		appType: "web",
 		root: e,
-		log: Z,
+		log: X,
 		generateTypes: !0
 	}), f = d.publicValues;
-	await Ni(e, t, r, f), Z.debug("generated framework entry files", { files: [
+	await $(e, t, r, f), X.debug("generated framework entry files", { files: [
 		"index.html",
 		".framework/main.tsx",
 		...t.env ? [".framework/env.public.ts"] : []
 	] });
-	let g = process.env.VOLTRO_IS_DASHBOARD === "1" && process.env.VOLTRO_DASHBOARD_PORT ? Number(process.env.VOLTRO_DASHBOARD_PORT) : t.port ?? 5173, _ = t.name ?? "unnamed", v = Ke("web", _, g), y = pr(_);
-	await We({
+	let g = process.env.VOLTRO_IS_DASHBOARD === "1" && process.env.VOLTRO_DASHBOARD_PORT ? Number(process.env.VOLTRO_DASHBOARD_PORT) : t.port ?? 5173, _ = t.name ?? "unnamed", v = qe("web", _, g), y = Nr(_);
+	await Ge({
 		id: v,
 		name: _,
 		kind: "web",
@@ -2537,22 +2806,22 @@ import {
 		pid: process.pid,
 		status: "booting",
 		logFile: y.path
-	}).catch(() => {}), await Pi(e, g);
-	let { pages: b, dirs: x } = await $(p(e, "src", "pages")), S = {
+	}).catch(() => {}), await ra(e, g);
+	let { pages: b, dirs: x } = await Q(p(e, "src", "pages")), S = {
 		dirs: x,
-		ssrRoutes: bi(b)
+		ssrRoutes: Wi(b)
 	}, w = x.map((e) => ({
 		dir: e.dir,
 		hasLayout: e.hasLayout,
 		hasError: e.hasError,
 		hasPending: e.hasPending,
 		hasNotFound: e.hasNotFound
-	})), E = await zt({
+	})), E = await on({
 		appRoot: e,
 		pages: b
 	});
-	E.wrote && Z.debug("routes codegen wrote", { path: m(e, E.path) });
-	let D = await Xe("vite", () => import("vite")), ee = (await import("@vitejs/plugin-react")).default, k = (await import("@tailwindcss/vite")).default, A = p(e, ".framework"), j = p(e, "src"), te = /* @__PURE__ */ new Set([
+	E.wrote && X.debug("routes codegen wrote", { path: m(e, E.path) });
+	let D = await Ze("vite", () => import("vite")), k = (await import("@vitejs/plugin-react")).default, A = (await import("@tailwindcss/vite")).default, j = p(e, ".framework"), M = p(e, "src"), N = /* @__PURE__ */ new Set([
 		".framework",
 		"node_modules",
 		"dist",
@@ -2560,15 +2829,15 @@ import {
 		".vite",
 		".turbo",
 		".cache"
-	]), ne = {
+	]), ee = {
 		name: "framework:watch-app-sources",
 		async configureServer(t) {
 			try {
-				let n = (await O.readdir(e, { withFileTypes: !0 })).filter((e) => e.isDirectory() && !te.has(e.name));
+				let n = (await O.readdir(e, { withFileTypes: !0 })).filter((e) => e.isDirectory() && !N.has(e.name));
 				for (let r of n) t.watcher.add(p(e, r.name));
-				n.length === 0 && t.watcher.add(j);
+				n.length === 0 && t.watcher.add(M);
 			} catch {
-				t.watcher.add(j);
+				t.watcher.add(M);
 			}
 			try {
 				let n = await O.readFile(p(e, "package.json"), "utf8"), r = JSON.parse(n), i = Object.keys({
@@ -2576,7 +2845,7 @@ import {
 					...r.devDependencies
 				});
 				await Promise.all(i.map(async (n) => {
-					let r = await Si(e, n);
+					let r = await Ki(e, n);
 					if (!r) return;
 					let i = p(r, "src");
 					try {
@@ -2585,63 +2854,63 @@ import {
 				}));
 			} catch {}
 		}
-	}, M = p(e, "src", "pages"), N = (e) => e.endsWith(".tsx") && (e === M || e.startsWith(M + "/")), re = (e) => e === M || e.startsWith(M + "/"), P = async (n) => {
+	}, P = p(e, "src", "pages"), F = (e) => e.endsWith(".tsx") && (e === P || e.startsWith(P + "/")), I = (e) => e === P || e.startsWith(P + "/"), te = async (n) => {
 		try {
 			let i = Date.now();
-			await Ni(e, t, r, f);
-			let { pages: a, dirs: o } = await $(M);
-			await zt({
+			await $(e, t, r, f);
+			let { pages: a, dirs: o } = await Q(P);
+			await on({
 				appRoot: e,
 				pages: a
-			}), S.dirs = o, S.ssrRoutes = bi(a), Z.info("page tree regenerated", {
+			}), S.dirs = o, S.ssrRoutes = Wi(a), X.info("page tree regenerated", {
 				reason: n,
 				ms: Date.now() - i,
 				routes: S.ssrRoutes.length
 			});
 		} catch (e) {
-			Z.error("page tree regen failed", { reason: n }, e);
+			X.error("page tree regen failed", { reason: n }, e);
 		}
-	}, F = {
+	}, L = {
 		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, P(e);
+					r.length = 0, te(e);
 				}, 50);
 			};
 			t.watcher.on("add", (t) => {
-				N(t) && i(`add ${m(e, t)}`);
+				F(t) && i(`add ${m(e, t)}`);
 			}), t.watcher.on("unlink", (t) => {
-				N(t) && i(`unlink ${m(e, t)}`);
+				F(t) && i(`unlink ${m(e, t)}`);
 			}), t.watcher.on("addDir", (t) => {
-				re(t) && i(`addDir ${m(e, t)}`);
+				I(t) && i(`addDir ${m(e, t)}`);
 			}), t.watcher.on("unlinkDir", (t) => {
-				re(t) && i(`unlinkDir ${m(e, t)}`);
+				I(t) && i(`unlinkDir ${m(e, t)}`);
 			});
 		}
-	}, I = p(e, "app.config.ts"), ie = (e) => {
-		if (!B(e.env)) return "";
+	}, R = p(e, "app.config.ts"), ne = (e) => {
+		if (!ae(e.env)) return "";
 		let t = Object.entries(e.env.vars).map(([e, t]) => `${e}:${t.access}`).sort();
 		return `${String(e.env.publicPrefix)}|${t.join(",")}`;
-	}, L = (e, t) => {
+	}, re = (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"), ie(e) !== ie(t) && n.push("env"), n;
-	}, R = t, z = h(I), ae = {
+		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"), ne(e) !== ne(t) && n.push("env"), n;
+	}, z = t, ie = h(R), B = {
 		name: "framework:watch-app-config",
 		async configureServer(t) {
-			t.watcher.add(I), Z.info("watching app.config.ts for changes", { path: m(e, I) });
+			t.watcher.add(R), X.info("watching app.config.ts for changes", { path: m(e, R) });
 			let n = async () => {
 				try {
 					try {
-						let e = t.moduleGraph.getModuleById(I);
+						let e = t.moduleGraph.getModuleById(R);
 						e && t.moduleGraph.invalidateModule(e);
 					} catch {}
-					let e = (await t.ssrLoadModule(I, { fixStacktrace: !0 })).default;
-					return typeof e == "object" && e && "type" in e && e.type === "web" ? e : (Z.warn("app.config.ts re-load returned wrong shape", { hasDefault: e !== void 0 }), null);
+					let e = (await t.ssrLoadModule(R, { fixStacktrace: !0 })).default;
+					return typeof e == "object" && e && "type" in e && e.type === "web" ? e : (X.warn("app.config.ts re-load returned wrong shape", { hasDefault: e !== void 0 }), null);
 				} catch (e) {
-					return Z.warn("app.config.ts re-load failed — ignoring this change", {}, e), null;
+					return X.warn("app.config.ts re-load failed — ignoring this change", {}, e), null;
 				}
 			}, r = null, i = () => {
 				r && clearTimeout(r), r = setTimeout(() => {
@@ -2650,20 +2919,20 @@ import {
 			}, a = async () => {
 				let r = await n();
 				if (!r) {
-					Z.info("app.config.ts onConfigChange: load returned null — skipping");
+					X.info("app.config.ts onConfigChange: load returned null — skipping");
 					return;
 				}
-				if (Z.info("app.config.ts onConfigChange: loaded", {
+				if (X.info("app.config.ts onConfigChange: loaded", {
 					theme: r.theme,
 					port: r.port,
 					name: r.name
-				}), JSON.stringify(r) === JSON.stringify(R)) {
-					Z.info("app.config.ts onConfigChange: parsed config unchanged — skipping (no-op edit?)");
+				}), JSON.stringify(r) === JSON.stringify(z)) {
+					X.info("app.config.ts onConfigChange: parsed config unchanged — skipping (no-op edit?)");
 					return;
 				}
-				let i = L(R, r);
+				let i = re(z, r);
 				if (i.length > 0) {
-					Z.warn("app.config.ts changed — hard restart required", { fields: i });
+					X.warn("app.config.ts changed — hard restart required", { fields: i });
 					try {
 						await t.close();
 					} catch {}
@@ -2677,45 +2946,45 @@ import {
 					process.on("SIGINT", r), process.on("SIGTERM", a), e.on("exit", (e, t) => {
 						process.off("SIGINT", r), process.off("SIGTERM", a), t ? process.kill(process.pid, t) : process.exit(e ?? 0);
 					}), e.on("error", (e) => {
-						Z.error("restart spawn failed", {}, e), process.exit(1);
+						X.error("restart spawn failed", {}, e), process.exit(1);
 					});
 					return;
 				}
 				try {
 					let n = Date.now();
-					await Ni(e, r, await Di(e, r)), R = r, t.ws && t.ws.send({
+					await $(e, r, await Zi(e, r)), z = r, t.ws && t.ws.send({
 						type: "full-reload",
 						path: "*"
-					}), Z.info("app.config.ts soft-regen", {
+					}), X.info("app.config.ts soft-regen", {
 						ms: Date.now() - n,
 						reload: "full"
 					});
 				} catch (e) {
-					Z.error("app.config.ts soft-regen failed", {}, e);
+					X.error("app.config.ts soft-regen failed", {}, e);
 				}
-			}, o = (e) => u(e) === "app.config.ts" ? e === I || h(e) === z : !1;
+			}, o = (e) => u(e) === "app.config.ts" ? e === R || h(e) === ie : !1;
 			t.watcher.on("change", (e) => {
-				o(e) && (Z.info("app.config.ts change event (chokidar)", { file: e }), i());
+				o(e) && (X.info("app.config.ts change event (chokidar)", { file: e }), i());
 			}), t.watcher.on("add", (e) => {
-				o(e) && (Z.info("app.config.ts add event (chokidar)", { file: e }), i());
+				o(e) && (X.info("app.config.ts add event (chokidar)", { file: e }), i());
 			});
 			try {
 				let { watchFile: e } = await import("node:fs");
-				e(I, { interval: 500 }, (e, t) => {
-					e.mtimeMs !== t.mtimeMs && (Z.info("app.config.ts change event (poll)", { mtime: e.mtimeMs }), i());
-				}), Z.info("app.config.ts polling watcher attached", { intervalMs: 500 });
+				e(R, { interval: 500 }, (e, t) => {
+					e.mtimeMs !== t.mtimeMs && (X.info("app.config.ts change event (poll)", { mtime: e.mtimeMs }), i());
+				}), X.info("app.config.ts polling watcher attached", { intervalMs: 500 });
 			} catch (e) {
-				Z.warn("app.config.ts polling watcher could not attach", {}, e);
+				X.warn("app.config.ts polling watcher could not attach", {}, e);
 			}
-			_t(mt, Z, {
+			vt(ht, X, {
 				root: e,
 				onBeforeRestart: () => t.close()
 			});
 		}
-	}, oe = /\/apps\/[^/]+\/.*\.(route|mutation|workflow|schema)\.tsx?$/, V = 0, se = {
+	}, V = /\/apps\/[^/]+\/.*\.(route|mutation|workflow|schema)\.tsx?$/, oe = 0, se = {
 		name: "framework:suppress-api-hmr",
 		handleHotUpdate(e) {
-			if (V += 1, oe.test(e.file)) return [];
+			if (oe += 1, V.test(e.file)) return [];
 		}
 	}, ce = {
 		name: "framework:reoptimize-on-rpcgroup-change",
@@ -2723,7 +2992,7 @@ import {
 			let n = /* @__PURE__ */ new Map();
 			for (let i of r) {
 				if (!i.proxyTarget) continue;
-				let r = await Si(e, i.pkg);
+				let r = await Ki(e, i.pkg);
 				if (!r) continue;
 				let a = p(r, "rpcGroup.generated.ts");
 				try {
@@ -2749,14 +3018,14 @@ import {
 					i !== t && (n.set(e, i), r = e);
 				}
 				if (r !== null) {
-					a = !0, Z.info(`rpcGroup changed (${m(e, r)}) — re-bundling the api client + reloading (descriptor edits propagate automatically; no manual restart needed)`);
+					a = !0, X.info(`rpcGroup changed (${m(e, r)}) — re-bundling the api client + reloading (descriptor edits propagate automatically; no manual restart needed)`);
 					try {
-						await O.rm(p(A, ".vite", "deps"), {
+						await O.rm(p(j, ".vite", "deps"), {
 							recursive: !0,
 							force: !0
 						}), await t.restart(!0);
 					} catch (e) {
-						a = !1, Z.error("rpcGroup re-optimize failed", {}, e);
+						a = !1, X.error("rpcGroup re-optimize failed", {}, e);
 					}
 				}
 			}, s = (e) => {
@@ -2768,7 +3037,7 @@ import {
 		}
 	}, H = {}, le = (e) => (t) => {
 		t.on("proxyReq", (t, n) => {
-			jn(t, n, {
+			Zn(t, n, {
 				target: e,
 				token: process.env.VOLTRO_INSPECT_TOKEN,
 				writeToken: process.env.VOLTRO_INSPECT_WRITE_TOKEN,
@@ -2794,14 +3063,14 @@ import {
 	}
 	for (let [e, n] of Object.entries(t.proxies ?? {})) {
 		if (H[e]) {
-			Z.warn("user proxy ignored — prefix already claimed by an api ws proxy", { prefix: e });
+			X.warn("user proxy ignored — prefix already claimed by an api ws proxy", { prefix: e });
 			continue;
 		}
 		H[e] = {
 			target: n.target,
 			changeOrigin: n.changeOrigin ?? !0,
 			...n.rewrite === void 0 ? {} : { rewrite: (t) => t.replace(RegExp(`^${e}`), n.rewrite) }
-		}, Z.info(`proxy ${e} → ${n.target}`, {
+		}, X.info(`proxy ${e} → ${n.target}`, {
 			prefix: e,
 			target: n.target,
 			...n.rewrite === void 0 ? {} : { rewrite: n.rewrite }
@@ -2819,18 +3088,18 @@ import {
 						pattern: n.pattern,
 						file: n.file,
 						dirChain: n.dirChain,
-						renderMode: Qn(i, p("src", "pages", n.file)),
+						renderMode: vr(i, p("src", "pages", n.file)),
 						interactive: i.interactive ?? "full",
 						tenantAware: i.tenantAware === !0,
-						revalidateMs: ct(i.revalidate),
-						staleWhileRevalidateMs: ct(i.staleWhileRevalidate) ?? 0,
+						revalidateMs: lt(i.revalidate),
+						staleWhileRevalidateMs: lt(i.staleWhileRevalidate) ?? 0,
 						cacheInvalidatesOn: Array.isArray(i.cacheInvalidatesOn) ? i.cacheInvalidatesOn : [],
 						hasLoader: typeof i.loader == "function",
 						hasMeta: i.meta != null,
 						hasGetStaticPaths: typeof i.getStaticPaths == "function"
 					});
 				} catch (e) {
-					Z.warn("inspect: failed to load page metadata", { pattern: n.pattern }, e);
+					X.warn("inspect: failed to load page metadata", { pattern: n.pattern }, e);
 				}
 				return u = t, t;
 			};
@@ -2850,9 +3119,9 @@ import {
 				}), r();
 			}), r.middlewares.use((t, n, r) => {
 				if (t.method !== "GET" && t.method !== "HEAD") return r();
-				let { pathname: i } = Ir(t.url ?? "/");
+				let { pathname: i } = ni(t.url ?? "/");
 				if (i !== "/robots.txt" || T(p(e, "public", "robots.txt"))) return r();
-				n.statusCode = 200, n.setHeader("Content-Type", "text/plain; charset=utf-8"), n.end(Gt({ indexable: !1 }));
+				n.statusCode = 200, n.setHeader("Content-Type", "text/plain; charset=utf-8"), n.end(fn({ indexable: !1 }));
 			}), t.name === "voltroDashboard" && r.middlewares.use(async (e, t, n) => {
 				let r = e.url ?? "", a = r.split("?")[0];
 				if (a === "/api/dashboard/proxy") {
@@ -2943,7 +3212,7 @@ import {
 				for (let [t, n] of Object.entries(e.headers ?? {})) n !== void 0 && (u[String(t).toLowerCase()] = Array.isArray(n) ? n.join(", ") : String(n));
 				let f = o.split("?")[0];
 				if (e.method === "GET" && (f === "/_voltro/inspect/logs" || o.startsWith("/_voltro/inspect/logs?"))) {
-					let e = a(u.origin), t = Tn(o, sn(), u);
+					let e = a(u.origin), t = Gn(o, Dn(), u);
 					r.statusCode = t.status, r.setHeader("content-type", t.contentType);
 					for (let [t, n] of Object.entries(e)) r.setHeader(t, n);
 					r.end(t.body);
@@ -2961,7 +3230,7 @@ import {
 					e.setEncoding("utf-8"), e.on("data", (e) => {
 						i += e;
 					}), e.on("end", () => {
-						let e = yn(i, n);
+						let e = zn(i, n);
 						r.statusCode = e.status, r.setHeader("content-type", e.contentType);
 						for (let [e, n] of Object.entries(t)) r.setHeader(e, n);
 						r.end(e.body);
@@ -2992,14 +3261,14 @@ import {
 					for (let [e, n] of Object.entries(t)) r.setHeader(e, n);
 					r.flushHeaders?.(), r.write("retry: 5000\n\n");
 					let l = o.indexOf("?");
-					if (!(l !== -1 && new URLSearchParams(o.slice(l + 1)).get("live") === "1")) for (let e of n.buffered()) r.write(Jt(e));
+					if (!(l !== -1 && new URLSearchParams(o.slice(l + 1)).get("live") === "1")) for (let e of n.buffered()) r.write(hn(e));
 					let d = n.subscribe((e) => {
 						try {
-							r.write(Jt(e));
+							r.write(hn(e));
 						} catch {}
 					}), f = setInterval(() => {
 						try {
-							r.write(Yt());
+							r.write(gn());
 						} catch {}
 					}, 15e3), p = () => {
 						clearInterval(f), d();
@@ -3012,7 +3281,7 @@ import {
 						kind: "web",
 						meta: {
 							name: t.name ?? "(unnamed)",
-							voltroVersion: ei,
+							voltroVersion: wi,
 							port: g,
 							mode: "dev",
 							apis: Object.entries(t.apis ?? {}).map(([e, t]) => {
@@ -3030,7 +3299,7 @@ import {
 							size: 0,
 							entries: []
 						}),
-						env: () => at(t.name ?? "app", { contract: B(t.env) ? t.env : void 0 })
+						env: () => ot(t.name ?? "app", { contract: ae(t.env) ? t.env : void 0 })
 					}, u, { method: e.method ?? "GET" });
 					if (n === null) return i();
 					r.statusCode = n.status, r.setHeader("content-type", n.contentType);
@@ -3047,19 +3316,19 @@ import {
 			e.middlewares.use(async (e, t, n) => {
 				if (!(e.url ?? "").startsWith("/api/dashboard/registry")) return n();
 				try {
-					let e = await Ue();
+					let e = await We();
 					t.statusCode = 200, t.setHeader("content-type", "application/json; charset=utf-8"), t.end(JSON.stringify(e));
 				} catch (e) {
 					t.statusCode = 500, t.setHeader("content-type", "text/plain"), t.end(`registry read error: ${e.message}`);
 				}
 			});
 		}
-	} : null, me = /* @__PURE__ */ new Set(), U = (e, t, n, r, i, a = !1) => {
-		let o = zr(i, a, t) ?? "";
-		if (Z.error(`${t} render failed`, {
+	} : null, me = /* @__PURE__ */ new Set(), he = (e, t, n, r, i, a = !1) => {
+		let o = li(i, a, t) ?? "";
+		if (X.error(`${t} render failed`, {
 			pathname: n,
 			pattern: r,
-			cause: Zt(i) + o
+			cause: vn(i) + o
 		}), e.headersSent) {
 			e.end();
 			return;
@@ -3067,58 +3336,70 @@ import {
 		e.writeHead(500, {
 			"content-type": "text/plain; charset=utf-8",
 			"x-voltro-rendered-by": `${t}-failed`,
-			"x-voltro-ssr-generation": String(V)
+			"x-voltro-ssr-generation": String(oe)
 		});
-		let s = V === 0 ? "" : `\n[voltro] this process has absorbed ${V} hot update(s) since boot, so its SSR\nmodule graph may not match the files on disk. Before reporting this — to us or to\nyourself — restart \`voltro dev\` and measure once from a fresh boot.\n`;
-		e.end(`${t} render failed for ${n}\n\n${Zt(i)}\n${o}\n${s}`);
-	}, W = Dt(), he = kt({
-		limit: W,
-		onColdStart: (e) => Z.debug("ssr cold-compile start", { id: e }),
-		onColdEnd: (e, { durationMs: t, failed: n }) => Z.debug(`ssr cold-compile ${n ? "FAILED" : "end"} ${t}ms`, {
+		let s = oe === 0 ? "" : `\n[voltro] this process has absorbed ${oe} hot update(s) since boot, so its SSR\nmodule graph may not match the files on disk. Before reporting this — to us or to\nyourself — restart \`voltro dev\` and measure once from a fresh boot.\n`;
+		e.end(`${t} render failed for ${n}\n\n${vn(i)}\n${o}\n${s}`);
+	}, U = qt(), ge = Yt({
+		limit: U,
+		onColdStart: (e) => X.debug("ssr cold-compile start", { id: e }),
+		onColdEnd: (e, { durationMs: t, failed: n }) => X.debug(`ssr cold-compile ${n ? "FAILED" : "end"} ${t}ms`, {
 			id: e,
 			ms: t,
 			...n ? { failed: !0 } : {}
 		})
 	});
-	Z.debug(`ssr cold-compile concurrency ${W}`, { concurrency: W });
-	let G = null, ge = async () => (G === null && (G = await O.readFile(p(e, ".framework", "index.html"), "utf8")), G), _e = {
+	X.debug(`ssr cold-compile concurrency ${U}`, { concurrency: U });
+	let W = null, _e = async () => (W === null && (W = await O.readFile(p(e, ".framework", "index.html"), "utf8")), W), ve = {
 		name: "framework:ssr",
 		configureServer(n) {
-			let i = (e) => he.load(e, async () => await n.ssrLoadModule(e)), a, o = () => {
+			let i = (e) => ge.load(e, async () => await n.ssrLoadModule(e)), a, o = !1, s = () => {
 				if (a !== void 0) return a;
 				let n = t.locales ?? [], r = t.defaultLocale ?? n[0] ?? "en";
 				return n.length === 0 ? (a = Promise.resolve(() => void 0), a) : (a = (async () => {
-					let [{ makeSsgWrap: t }, { makeSsrI18nResolver: a }] = await Promise.all([i("@voltro/i18n"), i("@voltro/i18n/server")]), o = {};
+					let [{ makeSsgWrap: t }, { makeSsrI18nResolver: a }] = await Promise.all([i("@voltro/i18n"), i("@voltro/i18n/server")]), s = {};
 					for (let a of n) if (T(p(e, "src", "locales", `${a}.ts`))) try {
 						let n = (await i(p(e, "src", "locales", `${a}.ts`))).default;
-						n !== void 0 && (o[a] = t(a, n, r));
+						n !== void 0 && (s[a] = t(a, n, r));
 					} catch (e) {
-						Z.warn("locale catalog failed to load for SSR", { locale: a }, e);
+						X.warn("locale catalog failed to load for SSR", { locale: a }, e);
+					}
+					if (o = Object.keys(s).length > 0, Object.keys(s).length === 0) {
+						let { resolveLocale: e } = await i("@voltro/i18n/server");
+						return (t, i) => ({
+							locale: e({
+								cookieHeader: t ?? null,
+								acceptLanguageHeader: i ?? null,
+								supported: n,
+								defaultLocale: r
+							}),
+							outerWrap: (e) => e
+						});
 					}
 					return a({
-						wraps: o,
+						wraps: s,
 						supported: n,
 						defaultLocale: r
 					});
 				})(), a);
 			};
-			n.middlewares.use(async (a, s, c) => {
-				if (a.method !== "GET" && a.method !== "HEAD") return c();
-				let l = a.url ?? "/";
-				l.indexOf("?");
-				let { pathname: u, search: d } = Ir(l);
-				if (u.startsWith("/@") || u.startsWith("/node_modules/") || u.startsWith("/.framework/") || u.startsWith("/_voltro/") || u === "/main.tsx" || u === "/index.html" || u === "/sw.js" || u === "/favicon.ico" || u === "/robots.txt" || /\.[a-z0-9]+$/i.test(u)) return c();
-				let f = xi(u, S.ssrRoutes);
-				if (!f) return c();
-				let m = !me.has(f.route.pattern), h = Date.now();
-				m && Z.info(`ssr compiling ${f.route.pattern}`, {
-					pattern: f.route.pattern,
-					pathname: u
+			n.middlewares.use(async (a, c, l) => {
+				if (a.method !== "GET" && a.method !== "HEAD") return l();
+				let u = a.url ?? "/";
+				u.indexOf("?");
+				let { pathname: d, search: f } = ni(u);
+				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" || /\.[a-z0-9]+$/i.test(d)) return l();
+				let m = Gi(d, S.ssrRoutes);
+				if (!m) return l();
+				let h = !me.has(m.route.pattern), g = Date.now();
+				h && X.info(`ssr compiling ${m.route.pattern}`, {
+					pattern: m.route.pattern,
+					pathname: d
 				});
-				let g = {}, _ = async (e, t) => {
+				let _ = {}, v = async (e, t) => {
 					let n = Date.now(), r = await t();
-					return g[e] = (g[e] ?? 0) + (Date.now() - n), r;
-				}, v = async (e, t, r) => {
+					return _[e] = (_[e] ?? 0) + (Date.now() - n), r;
+				}, y = async (e, t, r) => {
 					let i = await n.moduleGraph.getModuleById(e);
 					if (!(!i || t.has(e))) {
 						if (t.add(e), i.id && /\.(css|sass|scss|less|stylus|pcss|postcss)(\?|$)/.test(i.id)) {
@@ -3126,234 +3407,234 @@ import {
 							r.includes(e) || r.push(e);
 							return;
 						}
-						for (let e of i.importedModules ?? []) e.id && await v(e.id, t, r);
+						for (let e of i.importedModules ?? []) e.id && await y(e.id, t, r);
 					}
-				}, y = !1;
+				}, b = !1;
 				try {
-					let b = await _("loadPage", async () => await i(p(e, "src", "pages", f.route.file))), x = Qn(b, p("src", "pages", f.route.file)), C = hi(S.dirs, f.route.dirChain), w = x === "spa" && C.some((e) => e.hasLayout);
-					if (x !== "ssr" && x !== "isr" && !w) return c();
-					let T = {};
-					for (let [e, t] of Object.entries(a.headers ?? {})) typeof t == "string" ? T[e] = t : Array.isArray(t) && (T[e] = t.join(", "));
-					let E = Mi(ji(r[0], { allowDevProxy: !0 }), T.cookie, { apiName: r[0]?.name }), D = new AbortController(), O = () => D.abort();
-					s.once("close", O);
-					let ee = null, k = [], A = {};
+					let x = await v("loadPage", async () => await i(p(e, "src", "pages", m.route.file))), C = vr(x, p("src", "pages", m.route.file)), w = zi(S.dirs, m.route.dirChain), T = C === "spa" && w.some((e) => e.hasLayout);
+					if (C !== "ssr" && C !== "isr" && !T) return l();
+					let E = {};
+					for (let [e, t] of Object.entries(a.headers ?? {})) typeof t == "string" ? E[e] = t : Array.isArray(t) && (E[e] = t.join(", "));
+					let D = na(ta(r[0], { allowDevProxy: !0 }), E.cookie, { apiName: r[0]?.name }), O = new AbortController(), k = () => O.abort();
+					c.once("close", k);
+					let A = null, j = [], M = {};
 					try {
-						(await i("@voltro/web/ssr")).beginStoreSeeds(), {chain: k, segmentLoaderData: A} = await _("loadChain", () => gi({
-							entries: C,
+						(await i("@voltro/web/ssr")).beginStoreSeeds(), {chain: j, segmentLoaderData: M} = await v("loadChain", () => Bi({
+							entries: w,
 							loadLayout: (t) => i(p(e, "src", "pages", t.dir, "layout.tsx")),
 							loadError: (t) => i(p(e, "src", "pages", t.dir, "error.tsx")),
 							loadPending: (t) => i(p(e, "src", "pages", t.dir, "loading.tsx")),
 							ctx: {
-								params: f.params,
-								pathname: u,
-								search: d,
-								signal: D.signal,
-								headers: T,
-								query: E
+								params: m.params,
+								pathname: d,
+								search: f,
+								signal: O.signal,
+								headers: E,
+								query: D
 							}
 						}));
-						let t = b.loader;
-						typeof t == "function" && !w && (ee = await _("loader", () => t({
-							params: f.params,
-							pathname: u,
-							search: d,
-							signal: D.signal,
-							headers: T,
-							query: E
+						let t = x.loader;
+						typeof t == "function" && !T && (A = await v("loader", () => t({
+							params: m.params,
+							pathname: d,
+							search: f,
+							signal: O.signal,
+							headers: E,
+							query: D
 						})));
 					} finally {
-						s.off("close", O);
+						c.off("close", k);
 					}
-					let j = await _("loadSsrHelpers", async () => await i("@voltro/web/ssr"));
-					w || await Qr({
-						pageMod: b,
-						params: f.params,
-						query: E,
+					let N = await v("loadSsrHelpers", async () => await i("@voltro/web/ssr"));
+					T || await Si({
+						pageMod: x,
+						params: m.params,
+						query: D,
 						apiName: r[0]?.name,
-						seed: j.seedPreloadedSubscription,
-						onError: ({ tag: e, apiName: t }, n) => Z.warn("preload seed failed", {
+						seed: N.seedPreloadedSubscription,
+						onError: ({ tag: e, apiName: t }, n) => X.warn("preload seed failed", {
 							tag: e,
 							apiName: t,
-							pathname: u
+							pathname: d
 						}, n)
 					});
-					let te = {
-						pattern: f.route.pattern,
-						Component: b.default,
-						meta: b.meta,
-						loader: b.loader,
-						ErrorBoundary: b.ErrorBoundary,
-						Pending: b.Pending,
-						renderMode: x,
-						chain: k
-					}, ne = {
-						cookies: j.parseCookieHeader(T.cookie),
-						headers: T,
-						url: l
-					}, M = b.interactive ?? "full", N = (await o())(T.cookie, T["accept-language"]);
-					y = N !== void 0;
-					let re = N ? {
-						outerWrap: N.outerWrap,
-						locale: N.locale
-					} : {}, P = w ? Nr({
-						helpers: j,
-						page: `src/pages/${f.route.file}`,
-						interactive: M,
+					let ee = {
+						pattern: m.route.pattern,
+						Component: x.default,
+						meta: x.meta,
+						loader: x.loader,
+						ErrorBoundary: x.ErrorBoundary,
+						Pending: x.Pending,
+						renderMode: C,
+						chain: j
+					}, P = {
+						cookies: N.parseCookieHeader(E.cookie),
+						headers: E,
+						url: u
+					}, F = x.interactive ?? "full", I = (await s())(E.cookie, E["accept-language"]);
+					b = I !== void 0 && o;
+					let te = I ? {
+						outerWrap: I.outerWrap,
+						locale: I.locale
+					} : {}, L = T ? $r({
+						helpers: N,
+						page: `src/pages/${m.route.file}`,
+						interactive: F,
 						delivery: "stream",
 						renderInput: {
-							descriptor: te,
-							params: f.params,
-							pathname: u,
-							search: d,
-							segmentLoaderData: A,
-							requestContext: ne,
-							...re
+							descriptor: ee,
+							params: m.params,
+							pathname: d,
+							search: f,
+							segmentLoaderData: M,
+							requestContext: P,
+							...te
 						}
-					}) : null, F = w ? null : Mr({
-						helpers: j,
-						page: `src/pages/${f.route.file}`,
-						pathname: u,
-						renderMode: x,
-						interactive: M,
-						loaderData: ee,
-						segmentLoaderData: A,
-						pageLoaderRan: typeof b.loader == "function"
-					}), I = [];
-					await _("collectCss", async () => {
+					}) : null, R = T ? null : Qr({
+						helpers: N,
+						page: `src/pages/${m.route.file}`,
+						pathname: d,
+						renderMode: C,
+						interactive: F,
+						loaderData: A,
+						segmentLoaderData: M,
+						pageLoaderRan: typeof x.loader == "function"
+					}), ne = [];
+					await v("collectCss", async () => {
 						let t = /* @__PURE__ */ new Set(), n = [
-							p(e, "src", "pages", f.route.file),
-							...C.flatMap((t) => [
+							p(e, "src", "pages", m.route.file),
+							...w.flatMap((t) => [
 								...t.hasLayout ? [p(e, "src", "pages", t.dir, "layout.tsx")] : [],
 								...t.hasError ? [p(e, "src", "pages", t.dir, "error.tsx")] : [],
 								...t.hasPending ? [p(e, "src", "pages", t.dir, "loading.tsx")] : []
 							]),
 							p(e, ".framework", "main.tsx")
 						];
-						for (let e of n) await v(e, t, I);
+						for (let e of n) await y(e, t, ne);
 					});
-					let ie = await _("readShell", ge), L = await _("transformShell", () => n.transformIndexHtml(l, ie)), R = I.map((e) => `<link rel="stylesheet" href="${e}?direct" />`).join("\n    "), z = N?.locale ?? ne.cookies["voltro:locale"] ?? t.defaultLocale ?? (t.locales ?? [])[0] ?? "en", ae = Date.now();
-					if (P) {
-						let e = (e) => Fr({
-							helpers: j,
-							prepared: P,
+					let re = await v("readShell", _e), z = await v("transformShell", () => n.transformIndexHtml(u, re)), ie = ne.map((e) => `<link rel="stylesheet" href="${e}?direct" />`).join("\n    "), B = I?.locale ?? P.cookies["voltro:locale"] ?? t.defaultLocale ?? (t.locales ?? [])[0] ?? "en", ae = Date.now();
+					if (L) {
+						let e = (e) => ti({
+							helpers: N,
+							prepared: L,
 							meta: e,
-							interactive: M,
-							extra: [R]
+							interactive: F,
+							extra: [ie]
 						});
-						if (P.hasDeferred) Yr({
-							res: s,
-							shell: Kr({
-								shell: L,
+						if (L.hasDeferred) yi({
+							res: c,
+							shell: gi({
+								shell: z,
 								inlineModuleScriptsAsync: !0
 							}),
-							htmlLang: z,
+							htmlLang: B,
 							headers: {
 								"content-type": "text/html; charset=utf-8",
 								"x-voltro-rendered-by": "spa-shell-dev"
 							},
 							headInjection: e,
-							render: (e) => j.renderPageToStream({
-								...P.renderInput,
+							render: (e) => N.renderPageToStream({
+								...L.renderInput,
 								...e
 							}),
 							onShellError: (e) => {
-								U(s, "spa-shell-dev", u, f.route.pattern, e, y);
+								he(c, "spa-shell-dev", d, m.route.pattern, e, b);
 							}
 						});
 						else {
-							let t = Pr({
-								helpers: j,
-								prepared: P
-							}), n = L.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="${z}"`);
-							s.statusCode = 200, s.setHeader("content-type", "text/html; charset=utf-8"), s.setHeader("x-voltro-rendered-by", "spa-shell-dev"), s.end(n);
+							let t = ei({
+								helpers: N,
+								prepared: L
+							}), n = z.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="${B}"`);
+							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 (F) {
+					} else if (R) {
 						let e = (e) => [
-							R,
-							j.renderMetaToHtml(e),
-							`<meta name="voltro-interactive" content="${M}" />`,
-							...F.hasDeferred ? [j.renderDeferredRegistryScript()] : [],
-							j.renderRouterStateScript(F.stateInput)
+							ie,
+							N.renderMetaToHtml(e),
+							`<meta name="voltro-interactive" content="${F}" />`,
+							...R.hasDeferred ? [N.renderDeferredRegistryScript()] : [],
+							N.renderRouterStateScript(R.stateInput)
 						].filter((e) => e.length > 0).join("\n    "), t = {
-							descriptor: te,
-							params: f.params,
-							pathname: u,
-							search: d,
-							loaderData: F.loaderData,
-							segmentLoaderData: F.segmentLoaderData,
-							requestContext: ne,
-							...re
+							descriptor: ee,
+							params: m.params,
+							pathname: d,
+							search: f,
+							loaderData: R.loaderData,
+							segmentLoaderData: R.segmentLoaderData,
+							requestContext: P,
+							...te
 						};
-						if (x === "ssr" && M === "full") Yr({
-							res: s,
-							shell: Kr({
-								shell: L,
+						if (C === "ssr" && F === "full") yi({
+							res: c,
+							shell: gi({
+								shell: z,
 								inlineModuleScriptsAsync: !0
 							}),
-							htmlLang: z,
+							htmlLang: B,
 							headers: {
 								"content-type": "text/html; charset=utf-8",
 								"x-voltro-rendered-by": "ssr-dev"
 							},
 							headInjection: e,
-							render: (e) => j.renderPageToStream({
+							render: (e) => N.renderPageToStream({
 								...t,
 								...e
 							}),
 							onShellError: (e) => {
-								U(s, "ssr-dev", u, f.route.pattern, e, y);
+								he(c, "ssr-dev", d, m.route.pattern, e, b);
 							}
 						});
 						else {
-							let { html: n, meta: r } = j.renderPageToHtml(t), i = L.replace("<div id=\"root\"></div>", `<div id="root">${n}</div>`).replace("</head>", `    ${e(r)}\n  </head>`).replace(/<html(\s+lang="[^"]*")?/i, `<html lang="${z}"`);
-							s.statusCode = 200, s.setHeader("content-type", "text/html; charset=utf-8"), s.setHeader("x-voltro-rendered-by", "ssr-dev"), s.end(i);
+							let { html: n, meta: r } = N.renderPageToHtml(t), i = z.replace("<div id=\"root\"></div>", `<div id="root">${n}</div>`).replace("</head>", `    ${e(r)}\n  </head>`).replace(/<html(\s+lang="[^"]*")?/i, `<html lang="${B}"`);
+							c.statusCode = 200, c.setHeader("content-type", "text/html; charset=utf-8"), c.setHeader("x-voltro-rendered-by", "ssr-dev"), c.end(i);
 						}
 					}
-					g.render = Date.now() - ae;
-					let B = Date.now() - h;
-					m ? (me.add(f.route.pattern), Z.info(`ssr compiled ${f.route.pattern} in ${B}ms`, {
-						pattern: f.route.pattern,
-						pathname: u,
-						elapsedMs: B,
+					_.render = Date.now() - ae;
+					let V = Date.now() - g;
+					h ? (me.add(m.route.pattern), X.info(`ssr compiled ${m.route.pattern} in ${V}ms`, {
+						pattern: m.route.pattern,
+						pathname: d,
+						elapsedMs: V,
 						cold: !0,
-						phases: g
-					})) : B > 200 && Z.info(`ssr rendered ${u} in ${B}ms`, {
-						pattern: f.route.pattern,
-						pathname: u,
-						elapsedMs: B,
+						phases: _
+					})) : V > 200 && X.info(`ssr rendered ${d} in ${V}ms`, {
+						pattern: m.route.pattern,
+						pathname: d,
+						elapsedMs: V,
 						cold: !1,
-						phases: g
+						phases: _
 					});
 				} catch (e) {
-					if (Ar(e)) {
-						Z.error("ssr-dev render refused", {
-							pathname: u,
-							pattern: f.route.pattern
-						}, e), s.statusCode = 500, s.setHeader("content-type", "text/plain; charset=utf-8"), s.end(e.message);
+					if (Xr(e)) {
+						X.error("ssr-dev render refused", {
+							pathname: d,
+							pattern: m.route.pattern
+						}, e), c.statusCode = 500, c.setHeader("content-type", "text/plain; charset=utf-8"), c.end(e.message);
 						return;
 					}
-					let t = jr(e);
+					let t = Zr(e);
 					if (t) {
-						s.statusCode = t.status;
-						for (let [e, n] of Object.entries(t.headers)) s.setHeader(e, String(n));
-						s.end(t.body);
+						c.statusCode = t.status;
+						for (let [e, n] of Object.entries(t.headers)) c.setHeader(e, String(n));
+						c.end(t.body);
 						return;
 					}
-					U(s, "ssr-dev", u, f.route.pattern, e, y);
+					he(c, "ssr-dev", d, m.route.pattern, e, b);
 				}
 			});
 		}
-	}, ve = Date.now(), K = D.version ?? "?", q = await ti(), ye = p(e, "node_modules", "@voltro", "ui-shadcn"), J = T(p(ye, "package.json")) ? ye : null, be = [], xe = await (async () => {
+	}, ye = Date.now(), G = D.version ?? "?", K = await Ti(), be = p(e, "node_modules", "@voltro", "ui-shadcn"), q = T(p(be, "package.json")) ? be : null, xe = [], Se = await (async () => {
 		let t = [];
 		for (let n of r) {
 			if (!n.proxyTarget) continue;
-			let r = await Si(e, n.pkg);
+			let r = await Ki(e, n.pkg);
 			if (r) try {
 				t.push(await O.readFile(p(r, "rpcGroup.generated.ts"), "utf8"));
 			} catch {}
 		}
 		if (t.length === 0) return !1;
-		let n = de("sha1").update(t.join("\0")).digest("hex"), i = p(A, ".voltro-rpcgroup-optimize"), a = "";
+		let n = de("sha1").update(t.join("\0")).digest("hex"), i = p(j, ".voltro-rpcgroup-optimize"), a = "";
 		try {
 			a = (await O.readFile(i, "utf8")).trim();
 		} catch {}
@@ -3363,61 +3644,68 @@ import {
 		} catch {}
 		return !0;
 	})();
-	xe && Z.info("rpcGroup changed since last boot — forcing a dep re-optimize so the browser loads the current api client"), await (await D.createServer({
-		root: A,
+	Se && X.info("rpcGroup changed since last boot — forcing a dep re-optimize so the browser loads the current api client");
+	try {
+		await Tt(g, "voltro dev (web)");
+	} catch (e) {
+		X.error(String(e.message ?? e)), process.exit(1);
+	}
+	await (await D.createServer({
+		root: j,
 		envPrefix: "__VOLTRO_VITE_ENV_DISABLED__",
-		ssr: { noExternal: ["react-intl"] },
+		ssr: { noExternal: ["react-intl", "@voltro/i18n"] },
 		resolve: {
 			dedupe: [
 				"react",
 				"react-dom",
-				"react-intl"
+				"react-intl",
+				"@voltro/i18n"
 			],
 			alias: [
-				...q ? [{
+				...K ? [{
 					find: "@voltro/devtools/styles.css",
-					replacement: p(q, "src/styles.css")
+					replacement: p(K, "src/styles.css")
 				}, {
 					find: "@voltro/devtools",
-					replacement: p(q, "src/index.ts")
+					replacement: p(K, "src/index.ts")
 				}] : [],
-				...J ? [
+				...q ? [
 					{
 						find: "@voltro/ui-shadcn/tokens.css",
-						replacement: p(J, "src/tokens.css")
+						replacement: p(q, "src/tokens.css")
 					},
 					{
 						find: "@voltro/ui-shadcn/cn",
-						replacement: p(J, "src/cn.ts")
+						replacement: p(q, "src/cn.ts")
 					},
 					{
 						find: "@voltro/ui-shadcn/brand",
-						replacement: p(J, "src/brand/voltroLogo.tsx")
+						replacement: p(q, "src/brand/voltroLogo.tsx")
 					},
 					{
 						find: "@voltro/ui-shadcn",
-						replacement: p(J, "src/index.ts")
+						replacement: p(q, "src/index.ts")
 					}
 				] : [],
-				...Je(e)
+				...Ye(e)
 			]
 		},
 		optimizeDeps: {
-			include: [...r.map((e) => `${e.pkg}/rpcGroup`), ...be],
-			force: xe
+			include: [...r.map((e) => `${e.pkg}/rpcGroup`), ...xe],
+			force: Se
 		},
-		customLogger: Et(),
+		customLogger: Kt(),
 		plugins: [
-			Kn(p(e, "src", "pages")),
-			ee(),
+			fr(p(e, "src", "pages")),
 			k(),
-			ne,
-			F,
-			ae,
+			A(),
+			ee,
+			L,
+			B,
 			se,
 			ce,
 			ue,
-			_e,
+			ve,
 			...pe ? [pe] : []
 		],
 		server: {
@@ -3426,24 +3714,24 @@ import {
 			host: !0,
 			allowedHosts: t.allowedHosts === !0 || [...t.allowedHosts ?? []],
 			proxy: H,
-			fs: { allow: [e, ...si(e)] }
+			fs: { allow: [e, ...ji(e)] }
 		},
 		appType: "spa",
-		cacheDir: p(A, ".vite"),
+		cacheDir: p(j, ".vite"),
 		publicDir: p(e, "public")
-	})).listen(), $r.info(`v${K} ready in ${Date.now() - ve}ms`, {
-		version: K,
-		bootMs: Date.now() - ve
-	}), Z.info(`listening on http://localhost:${g}`, {
+	})).listen(), Ci.info(`v${G} ready in ${Date.now() - ye}ms`, {
+		version: G,
+		bootMs: Date.now() - ye
+	}), X.info(`listening on http://localhost:${g}`, {
 		port: g,
 		app: t.name ?? "(unnamed)"
 	});
-	for (let e of r) e.proxyTarget && (Z.info(`proxy /ws/${e.name} → ${e.proxyTarget}`, {
+	for (let e of r) e.proxyTarget && (X.info(`proxy /ws/${e.name} → ${e.proxyTarget}`, {
 		api: e.name,
 		target: e.proxyTarget
-	}), Z.info(`proxy /_voltro/api/${e.name} → ${e.proxyTarget.replace(/^ws/, "http")}/_voltro/inspect`, { api: e.name }));
+	}), X.info(`proxy /_voltro/api/${e.name} → ${e.proxyTarget.replace(/^ws/, "http")}/_voltro/inspect`, { api: e.name }));
 	try {
-		await We({
+		await Ge({
 			id: v,
 			name: _,
 			kind: "web",
@@ -3452,13 +3740,13 @@ import {
 			status: "live",
 			logFile: y.path
 		});
-		let t = vr(e);
+		let t = Rr(e);
 		if (t) {
-			let e = await Or({ dashboardAppPath: t });
-			e.status === "launched" ? Z.info(`dashboard launched at http://localhost:${e.port}`, { port: e.port }) : e.status === "already-running" && Z.debug(`dashboard already running on :${e.port}`, { port: e.port });
+			let e = await Jr({ dashboardAppPath: t });
+			e.status === "launched" ? X.info(`dashboard launched at http://localhost:${e.port}`, { port: e.port }) : e.status === "already-running" && X.debug(`dashboard already running on :${e.port}`, { port: e.port });
 		}
 		setInterval(() => {
-			We({
+			Ge({
 				id: v,
 				name: _,
 				kind: "web",
@@ -3469,54 +3757,55 @@ import {
 			}).catch(() => {});
 		}, 1e4).unref();
 		let n = () => {
-			Ge(v), y.dispose();
+			Ke(v), y.dispose();
 		};
 		process.on("SIGINT", n), process.on("SIGTERM", n);
 	} catch (e) {
-		Z.warn("runtime-registry write failed", {}, e);
+		X.warn("runtime-registry write failed", {}, e);
 	}
 	return C({
 		app: t.name ?? "unnamed",
 		kind: "web",
 		url: `http://localhost:${g}`,
-		bootMs: Date.now() - ve
+		bootMs: Date.now() - ye
 	}), new Promise(() => {});
-}, Ri = async (e) => {
+}, sa = async (e) => {
 	process.env.NODE_ENV || (process.env.NODE_ENV = "production");
-	let t = await Ii(e);
+	let t = await aa(e);
 	if (!t) return {
 		ran: !1,
 		exitCode: 0
 	};
-	let n = Date.now(), r = Z.child("serve");
+	let n = Date.now(), r = X.child("serve");
 	r.info("booting voltro serve (preview)", { app: t.name ?? "(unnamed)" });
-	let i = await Di(e, t);
+	let i = await Zi(e, t);
 	for (let e of i) r.info("api wired", {
 		name: e.name,
 		pkg: e.pkg
 	});
-	await Ni(e, t, i);
+	await $(e, t, i);
 	{
-		let { pages: t } = await $(p(e, "src", "pages"));
-		await zt({
+		let { pages: t } = await Q(p(e, "src", "pages"));
+		await on({
 			appRoot: e,
 			pages: t
 		});
 	}
-	let a = t.port ?? 5173, o = await Xe("vite", () => import("vite")), s = (await import("@vitejs/plugin-react")).default, c = p(e, ".framework");
-	Z.info("running production build"), await o.build({
+	let a = t.port ?? 5173, o = await Ze("vite", () => import("vite")), s = (await import("@vitejs/plugin-react")).default, c = p(e, ".framework");
+	X.info("running production build"), await o.build({
 		root: c,
 		envPrefix: "__VOLTRO_VITE_ENV_DISABLED__",
 		plugins: [s()],
-		customLogger: Et(),
+		customLogger: Kt(),
 		resolve: { dedupe: [
 			"react",
 			"react-dom",
-			"react-intl"
+			"react-intl",
+			"@voltro/i18n"
 		] },
 		build: {
 			outDir: "dist",
-			rollupOptions: { output: { manualChunks: li } }
+			rollupOptions: { output: { manualChunks: Ni } }
 		},
 		publicDir: p(e, "public")
 	});
@@ -3536,14 +3825,14 @@ import {
 		extras: d,
 		bootMs: Date.now() - n
 	}), new Promise(() => {});
-}, zi = 5e3, Bi = 6e4, Vi = (e, t) => {
+}, ca = 5e3, la = 6e4, ua = (e, t) => {
 	if (e.length === 0) return 0;
 	if (e.length === 1) return e[0];
 	let n = t * (e.length - 1), r = Math.floor(n), i = Math.ceil(n);
 	if (r === i) return e[r];
 	let a = n - r;
 	return e[r] * (1 - a) + e[i] * a;
-}, Hi = (e) => {
+}, da = (e) => {
 	if (e.length === 0) return {
 		p50: 0,
 		p95: 0,
@@ -3555,18 +3844,18 @@ import {
 	let t = e.slice().sort((e, t) => e - t), n = 0;
 	for (let e of t) n += e;
 	return {
-		p50: Vi(t, .5),
-		p95: Vi(t, .95),
-		p99: Vi(t, .99),
+		p50: ua(t, .5),
+		p95: ua(t, .95),
+		p99: ua(t, .99),
 		mean: n / t.length,
 		min: t[0],
 		max: t[t.length - 1]
 	};
-}, Ui = (e = {}) => {
-	let t = e.maxSamples ?? zi, n = e.defaultWindowMs ?? Bi, r = [];
+}, fa = (e = {}) => {
+	let t = e.maxSamples ?? ca, n = e.defaultWindowMs ?? la, r = [];
 	return {
 		record(e) {
-			re(e), r.push({
+			I(e), r.push({
 				...e,
 				ts: Date.now()
 			}), r.length > t && r.shift();
@@ -3592,7 +3881,7 @@ import {
 					tag: e.tag,
 					count: e.samples.length,
 					errorCount: n,
-					latencyMs: Hi(t)
+					latencyMs: da(t)
 				});
 			}
 			return c.sort((e, t) => t.count - e.count), {
@@ -3605,4 +3894,4 @@ import {
 	};
 };
 //#endregion
-export { Dt as $, mr as A, An as B, Ir as C, vr as D, Or as E, Jn as F, sn as G, xn as H, Xn as I, Yt as J, Jt as K, Qn as L, rr as M, qn as N, fr as O, $n as P, kt as Q, In as R, Fr as S, _r as T, yn as U, Tn as V, fn as W, Wt as X, Gt as Y, zt as Z, Yr as _, Ge as _t, gi as a, dt as at, Nr as b, Ne as bt, Di as c, at as ct, li as d, tt as dt, _t as et, $ as f, et as ft, Kr as g, Ue as gt, qr as h, Ke as ht, Mi as i, ut as it, tr as j, pr as k, Li as l, ot as lt, Qr as m, Je as mt, ui as n, mt as nt, hi as o, st as ot, Ni as p, Xe as pt, qt as q, ji as r, lt as rt, Ii as s, ct as st, Ui as t, ht as tt, Ri as u, rt as ut, Ar as v, We as vt, yr as w, Pr as x, Mr as y, Me as yt, Ln as z };
+export { qt as $, Pr as A, Xn as B, ni as C, We as Ct, Rr as D, Pe as Dt, Jr as E, Ne as Et, mr as F, Dn as G, Vn as H, gr as I, gn as J, hn as K, vr as L, Cr as M, pr as N, Mr as O, yr as P, Yt as Q, nr as R, ti as S, qe as St, Lr as T, Ge as Tt, zn as U, Gn as V, Mn as W, dn as X, fn as Y, on as Z, yi as _, it as _t, Bi as a, Tt as at, $r as b, Ze as bt, Zi as c, gt as ct, Ni as d, dt, Nt as et, Q as f, ft, gi as g, st as gt, _i as h, ot as ht, na as i, Lt as it, xr as j, Nr as k, oa as l, ht as lt, Si as m, lt as mt, Pi as n, Pt as nt, zi as o, bt as ot, $ as p, ct as pt, mn as q, ta as r, It as rt, aa as s, vt as st, fa as t, Ft as tt, sa as u, ut, Xr as v, nt as vt, zr as w, Ke as wt, ei as x, Ye as xt, Qr as y, tt as yt, rr as z };