@voltro/cli 0.12.0 → 0.14.0

package/dist/{inspectMetrics-uEfIS1vp.js → inspectMetrics-CyVMeofr.js}

@@ -1,23 +1,24 @@
-import { D as e, E as t, T as n, a as r, p as i, w as a } from "./inspect-Dwx0_tUj.js";
-import { basename as o, dirname as s, isAbsolute as c, join as l, relative as u, resolve as d } from "node:path";
-import { fileURLToPath as f, pathToFileURL as p } from "node:url";
-import { FileSystem as m } from "@effect/platform";
-import { NodeContext as h, NodeRuntime as g } from "@effect/platform-node";
-import { Cause as _, Effect as v, Layer as y } from "effect";
-import { LoggerLayer as b, 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 k, readdirSync as A, statSync as j, unlinkSync as M, unwatchFile as N, watchFile as P, writeSync as ee } from "node:fs";
-import { currentTraceContext as F, recordSample as te, resolveSecret as I } from "@voltro/runtime";
-import { createRequire as L } from "node:module";
-import { homedir as R } from "node:os";
-import { FRAMEWORK_ENV_CATALOG as ne, appEnvEntries as re, checkEnvNaming as ie, formatEnvErrors as ae, installEnvSnapshot as oe, isEnvContract as se, pluginEnvEntries as ce, renderDotEnvExample as le, resolveEnv as z } from "@voltro/env";
-import { __installPublicEnv as ue } from "@voltro/env/public";
-import { mkdir as de, readFile as fe, writeFile as B } from "node:fs/promises";
-import { createHash as pe } from "node:crypto";
-import { spawn as me } from "node:child_process";
-import { createConnection as he } from "node:net";
-import { PassThrough as ge } from "node:stream";
+import { d as e, u as t, x as n } from "./fileConventions-COg0ZytD.js";
+import { D as r, E as i, T as a, a as o, p as s, w as c } from "./inspect-Dwx0_tUj.js";
+import { basename as l, dirname as u, isAbsolute as d, join as f, relative as p, resolve as m } from "node:path";
+import { fileURLToPath as h, pathToFileURL as g } from "node:url";
+import { FileSystem as _ } from "@effect/platform";
+import { NodeContext as v, NodeRuntime as y } from "@effect/platform-node";
+import { Cause as b, Effect as x, Layer as S } from "effect";
+import { LoggerLayer as C, addSink as w, createLogger as T, printReadyBlock as E } from "@voltro/logger";
+import { closeSync as D, existsSync as O, mkdirSync as k, openSync as A, promises as j, readFileSync as M, readdirSync as N, statSync as P, unlinkSync as ee, unwatchFile as F, watchFile as te, writeSync as I } from "node:fs";
+import { currentTraceContext as L, recordSample as R, resolveSecret as ne } from "@voltro/runtime";
+import { createRequire as re } from "node:module";
+import { homedir as ie } from "node:os";
+import { FRAMEWORK_ENV_CATALOG as ae, appEnvEntries as oe, checkEnvNaming as se, formatEnvErrors as ce, installEnvSnapshot as z, isEnvContract as le, pluginEnvEntries as ue, renderDotEnvExample as de, resolveEnv as fe } from "@voltro/env";
+import { __installPublicEnv as pe } from "@voltro/env/public";
+import { mkdir as B, readFile as me, writeFile as V } from "node:fs/promises";
+import { createHash as he } from "node:crypto";
+import { spawn as ge } from "node:child_process";
+import { createConnection as _e } from "node:net";
+import { PassThrough as ve } from "node:stream";
 //#region src/cliRuntime.ts
-var _e = [
+var ye = [
 	"severity",
 	"code",
 	"detail",
@@ -34,14 +35,14 @@ var _e = [
 	"file",
 	"line",
 	"routine"
-], ve = (e, t = 0, n = /* @__PURE__ */ new WeakSet()) => {
+], H = (e, t = 0, n = /* @__PURE__ */ new WeakSet()) => {
 	if (t > 10 || typeof e != "object" || !e || n.has(e)) return null;
 	n.add(e);
 	let r = e, i = r.message;
 	if (typeof i == "string" && i.length > 0 && i !== "Failed to execute statement") {
 		let e = { message: i };
 		typeof r.stack == "string" && (e.stack = r.stack);
-		for (let t of _e) r[t] !== void 0 && (e[t] = r[t]);
+		for (let t of ye) r[t] !== void 0 && (e[t] = r[t]);
 		return e;
 	}
 	for (let e of [
@@ -54,24 +55,24 @@ var _e = [
 	]) {
 		let i = r[e];
 		if (i !== void 0) {
-			let e = ve(i, t + 1, n);
+			let e = H(i, t + 1, n);
 			if (e) return e;
 		}
 	}
 	if (Array.isArray(r.failures)) for (let e of r.failures) {
-		let r = ve(e, t + 1, n);
+		let r = H(e, t + 1, n);
 		if (r) return r;
 	}
 	return null;
-}, ye = (e = {}) => y.merge(h.layer, b({
+}, U = (e = {}) => S.merge(v.layer, C({
 	...e.scope ? { defaultScope: e.scope } : {},
 	...e.logger
-})), V = async (e, t = {}) => {
-	let n = e.pipe(v.provide(ye(t)));
-	return await v.runPromise(v.matchCauseEffect(n, {
-		onSuccess: (e) => v.succeed(e),
+})), be = async (e, t = {}) => {
+	let n = e.pipe(x.provide(U(t)));
+	return await x.runPromise(x.matchCauseEffect(n, {
+		onSuccess: (e) => x.succeed(e),
 		onFailure: (e) => {
-			let t = [..._.defects(e)];
+			let t = [...b.defects(e)];
 			if (process.env.VOLTRO_CAUSE_DEBUG === "1") for (let [e, n] of t.entries()) {
 				let t = Object.getOwnPropertyNames(n);
 				process.stderr.write(`[VOLTRO_CAUSE_DEBUG] defect[${e}] ctor=${n?.constructor?.name} props=${JSON.stringify(t)}\n`);
@@ -83,7 +84,7 @@ var _e = [
 			}
 			let n = null;
 			for (let e of t) {
-				let t = ve(e);
+				let t = H(e);
 				if (t) {
 					n = t;
 					break;
@@ -98,55 +99,55 @@ var _e = [
 				...n.column ? { pgColumn: n.column } : {},
 				...n.constraint ? { pgConstraint: n.constraint } : {},
 				...n.routine ? { pgRoutine: n.routine } : {},
-				causePretty: _.pretty(e)
-			} : { causePretty: _.pretty(e) };
-			return v.zipRight(v.logError("cli command failed", r), v.succeed(1));
+				causePretty: b.pretty(e)
+			} : { causePretty: b.pretty(e) };
+			return x.zipRight(x.logError("cli command failed", r), x.succeed(1));
 		}
-	}).pipe(v.provide(b(t.logger ?? {}))));
-}, be = (e, t = {}) => {
-	let n = e.pipe(v.provide(ye(t)));
-	g.runMain(n, { disableErrorReporting: !1 });
-}, xe = s(f(import.meta.url)), H = [d(xe, "..", "templates"), d(xe, "..", "..", "templates")], U = (e) => ({
+	}).pipe(x.provide(C(t.logger ?? {}))));
+}, W = (e, t = {}) => {
+	let n = e.pipe(x.provide(U(t)));
+	y.runMain(n, { disableErrorReporting: !1 });
+}, xe = u(h(import.meta.url)), G = [m(xe, "..", "templates"), m(xe, "..", "..", "templates")], Se = (e) => ({
 	_tag: "TemplateNotFoundError",
 	searched: e
-}), Se = ["AGENTS.md", "CLAUDE.md"], Ce = "voltro:agents-md:keep", we = 2048, Te = "<!-- VOLTRO:INDEX -->", W = (e, t) => e.exists(t).pipe(v.orElseSucceed(() => !1)), G = (e, t) => e.readFileString(t).pipe(v.orElseSucceed(() => "")), Ee = (e, t) => e.readFileString(t).pipe(v.map((e) => {
+}), Ce = ["AGENTS.md", "CLAUDE.md"], we = "voltro:agents-md:keep", Te = 2048, Ee = "<!-- VOLTRO:INDEX -->", K = (e, t) => e.exists(t).pipe(x.orElseSucceed(() => !1)), q = (e, t) => e.readFileString(t).pipe(x.orElseSucceed(() => "")), De = (e, t) => e.readFileString(t).pipe(x.map((e) => {
 	try {
 		return JSON.parse(e).workspaces !== void 0;
 	} catch {
 		return !1;
 	}
-}), v.orElseSucceed(() => !1)), De = (e) => v.gen(function* () {
-	let t = yield* m.FileSystem, n = d(e);
+}), x.orElseSucceed(() => !1)), Oe = (e) => x.gen(function* () {
+	let t = yield* _.FileSystem, n = m(e);
 	for (;;) {
-		if ((yield* W(t, l(n, ".git"))) || (yield* W(t, l(n, "pnpm-workspace.yaml"))) || (yield* Ee(t, l(n, "package.json")))) return n;
-		let r = s(n);
-		if (r === n) return d(e);
+		if ((yield* K(t, f(n, ".git"))) || (yield* K(t, f(n, "pnpm-workspace.yaml"))) || (yield* De(t, f(n, "package.json")))) return n;
+		let r = u(n);
+		if (r === n) return m(e);
 		n = r;
 	}
-}), Oe = (e, t, n) => v.gen(function* () {
-	yield* e.makeDirectory(n, { recursive: !0 }).pipe(v.orElseSucceed(() => void 0));
-	let r = yield* e.readDirectory(t).pipe(v.orElseSucceed(() => []));
+}), ke = (e, t, n) => x.gen(function* () {
+	yield* e.makeDirectory(n, { recursive: !0 }).pipe(x.orElseSucceed(() => void 0));
+	let r = yield* e.readDirectory(t).pipe(x.orElseSucceed(() => []));
 	for (let i of r) {
-		let r = l(t, i), a = l(n, i);
-		(yield* e.stat(r).pipe(v.orElseSucceed(() => null)))?.type === "Directory" ? yield* Oe(e, r, a) : yield* e.copyFile(r, a).pipe(v.orElseSucceed(() => void 0));
-	}
-}), ke = (e) => typeof e?.name == "string" && e.name.length > 0 ? e.name.split("#")[0] : null, Ae = (e, t) => v.gen(function* () {
-	let n = l(t, "app.config.ts");
-	if (!(yield* W(e, n))) return null;
-	let r = (yield* v.tryPromise(() => import(p(n).href)).pipe(v.orElseSucceed(() => null)))?.default;
-	return !r || r.type && r.type !== "api" ? r?.type === "web" ? [] : null : (r.plugins ?? []).map(ke).filter((e) => e !== null);
-}), je = (e, t) => v.gen(function* () {
-	let n = [], r = [], i = l(t, "apps");
-	if (!(yield* W(e, i))) return {
+		let r = f(t, i), a = f(n, i);
+		(yield* e.stat(r).pipe(x.orElseSucceed(() => null)))?.type === "Directory" ? yield* ke(e, r, a) : yield* e.copyFile(r, a).pipe(x.orElseSucceed(() => void 0));
+	}
+}), Ae = (e) => typeof e?.name == "string" && e.name.length > 0 ? e.name.split("#")[0] : null, je = (e, t) => x.gen(function* () {
+	let n = f(t, "app.config.ts");
+	if (!(yield* K(e, n))) return null;
+	let r = (yield* x.tryPromise(() => import(g(n).href)).pipe(x.orElseSucceed(() => null)))?.default;
+	return !r || r.type && r.type !== "api" ? r?.type === "web" ? [] : null : (r.plugins ?? []).map(Ae).filter((e) => e !== null);
+}), Me = (e, t) => x.gen(function* () {
+	let n = [], r = [], i = f(t, "apps");
+	if (!(yield* K(e, i))) return {
 		apis: n,
 		webs: r
 	};
-	for (let t of yield* e.readDirectory(i).pipe(v.orElseSucceed(() => []))) {
-		let a = l(i, t);
-		if ((yield* e.stat(a).pipe(v.orElseSucceed(() => null)))?.type === "Directory") for (let t of yield* e.readDirectory(a).pipe(v.orElseSucceed(() => []))) {
-			let i = l(a, t), o = l(i, "app.config.ts");
-			if (!(yield* W(e, o))) continue;
-			let s = yield* G(e, o);
+	for (let t of yield* e.readDirectory(i).pipe(x.orElseSucceed(() => []))) {
+		let a = f(i, t);
+		if ((yield* e.stat(a).pipe(x.orElseSucceed(() => null)))?.type === "Directory") for (let t of yield* e.readDirectory(a).pipe(x.orElseSucceed(() => []))) {
+			let i = f(a, t), o = f(i, "app.config.ts");
+			if (!(yield* K(e, o))) continue;
+			let s = yield* q(e, o);
 			/type:\s*['"]web['"]/.test(s) ? r.push(i) : n.push(i);
 		}
 	}
@@ -154,7 +155,7 @@ var _e = [
 		apis: n,
 		webs: r
 	};
-}), Me = (e) => e.replace(/\|/g, "\\|").replace(/\n/g, " ").trim(), Ne = (e, t, n) => {
+}), Ne = (e) => e.replace(/\|/g, "\\|").replace(/\n/g, " ").trim(), Pe = (e, t, n) => {
 	let r = [
 		"<!-- voltro agent-docs index — regenerated at seed time -->",
 		"## Deep reference (read on demand)",
@@ -166,17 +167,17 @@ var _e = [
 		"",
 		"| Topic | Open | Summary |",
 		"|---|---|---|",
-		...e.modules.map((e) => `| ${e.title} | \`${n}${e.path}\` | ${Me(e.description)} |`),
+		...e.modules.map((e) => `| ${e.title} | \`${n}${e.path}\` | ${Ne(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\` | ${Me(e.description)} |`) : t.map((e) => {
+	], 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\` | ${Ne(e.description)} |`) : t.map((e) => {
 		let t = i.get(e);
-		return t ? `| ${t.slug} | \`node_modules/${e}/README.md\` | ${Me(t.description)} |` : `| ${e.replace(/^@[^/]+\//, "")} | \`node_modules/${e}/README.md\` | (see plugin README) |`;
+		return t ? `| ${t.slug} | \`node_modules/${e}/README.md\` | ${Ne(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");
-}, Pe = (e, t, n) => {
+}, Fe = (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`;
-}, Fe = {
+}, Ie = {
 	api: (e, t, n = "") => `# api — agent notes
 
 You are in a Voltro **api** app. Server primitives live here: \`queries/\`,
@@ -216,7 +217,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}`
-}, Ie = [
+}, Le = [
 	{
 		name: "voltro-schema",
 		description: "Define or change a Voltro database table/schema (columns, mixins, indexes, relations).",
@@ -247,7 +248,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"
 	}
-], Le = (e, t) => `---
+], Re = (e, t) => `---
 name: ${e.name}
 description: ${e.description}
 ---
@@ -258,10 +259,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.
-`, Re = (e, t, n, r) => v.gen(function* () {
-	let i = yield* W(e, t);
+`, ze = (e, t, n, r) => x.gen(function* () {
+	let i = yield* K(e, t);
 	if (i) {
-		if ((yield* G(e, t)).slice(0, we).includes("voltro:agents-md:keep")) return {
+		if ((yield* q(e, t)).slice(0, Te).includes("voltro:agents-md:keep")) return {
 			path: t,
 			action: "protected"
 		};
@@ -270,68 +271,68 @@ boundary, naming, anti-patterns) before editing.
 			action: "present"
 		};
 	}
-	return yield* e.makeDirectory(s(t), { recursive: !0 }).pipe(v.orElseSucceed(() => void 0)), yield* e.writeFileString(t, n).pipe(v.orDie), {
+	return yield* e.makeDirectory(u(t), { recursive: !0 }).pipe(x.orElseSucceed(() => void 0)), yield* e.writeFileString(t, n).pipe(x.orDie), {
 		path: t,
 		action: i ? "overwritten" : "created"
 	};
-}), ze = (e, t = {}) => v.gen(function* () {
-	let n = yield* m.FileSystem, r = yield* De(e), i = null;
-	for (let e of H) if (yield* W(n, l(e, "AGENTS.core.md"))) {
+}), Be = (e, t = {}) => x.gen(function* () {
+	let n = yield* _.FileSystem, r = yield* Oe(e), i = null;
+	for (let e of G) if (yield* K(n, f(e, "AGENTS.core.md"))) {
 		i = e;
 		break;
 	}
 	if (i === null) {
-		for (let e of H) if (yield* W(n, l(e, "AGENTS.md"))) {
-			let i = yield* G(n, l(e, "AGENTS.md")), a = [];
-			for (let e of Se) a.push(yield* Re(n, l(r, e), i, t.force ?? !1));
+		for (let e of G) if (yield* K(n, f(e, "AGENTS.md"))) {
+			let i = yield* q(n, f(e, "AGENTS.md")), a = [];
+			for (let e of Ce) a.push(yield* ze(n, f(r, e), i, t.force ?? !1));
 			return { files: a };
 		}
-		return yield* v.fail(U(H.map((e) => l(e, "AGENTS.core.md"))));
+		return yield* x.fail(Se(G.map((e) => f(e, "AGENTS.core.md"))));
 	}
-	let a = yield* G(n, l(i, "AGENTS.core.md")), o = yield* G(n, l(i, "agent-docs", "_manifest.json")), s = o ? JSON.parse(o) : {
+	let a = yield* q(n, f(i, "AGENTS.core.md")), o = yield* q(n, f(i, "agent-docs", "_manifest.json")), s = o ? JSON.parse(o) : {
 		modules: [],
 		plugins: []
-	}, c = (t.preferPointer ?? !1) || (yield* W(n, l(r, "node_modules/@voltro/cli/templates/agent-docs", "_manifest.json"))), u = c ? "node_modules/@voltro/cli/templates/" : "", f = t.force ?? !1, p = Se.map((e) => l(r, e));
-	if ((yield* v.forEach(p, (e) => G(n, e).pipe(v.map((e) => e.slice(0, we))))).every((e) => e.includes("voltro:agents-md:keep"))) return { files: p.map((e) => ({
+	}, c = (t.preferPointer ?? !1) || (yield* K(n, f(r, "node_modules/@voltro/cli/templates/agent-docs", "_manifest.json"))), l = c ? "node_modules/@voltro/cli/templates/" : "", u = t.force ?? !1, d = Ce.map((e) => f(r, e));
+	if ((yield* x.forEach(d, (e) => q(n, e).pipe(x.map((e) => e.slice(0, Te))))).every((e) => e.includes("voltro:agents-md:keep"))) return { files: d.map((e) => ({
 		path: e,
 		action: "protected"
 	})) };
-	let { apis: h, webs: g } = yield* je(n, r), _ = /* @__PURE__ */ new Map(), y = /* @__PURE__ */ new Set(), b = !1;
-	for (let e of h) {
-		let t = yield* Ae(n, e);
-		if (_.set(e, t), t !== null) {
-			b = !0;
-			for (let e of t) y.add(e);
+	let { apis: p, webs: h } = yield* Me(n, r), g = /* @__PURE__ */ new Map(), v = /* @__PURE__ */ new Set(), y = !1;
+	for (let e of p) {
+		let t = yield* je(n, e);
+		if (g.set(e, t), t !== null) {
+			y = !0;
+			for (let e of t) v.add(e);
 		}
 	}
-	let x = t.plugins ? t.plugins.map(ke).filter((e) => e !== null) : b ? [...y] : null, S = a.includes(Te) ? a.replace(Te, Ne(s, x, u)) : a, C = [];
-	for (let e of p) C.push(yield* Re(n, e, S, f));
-	c || (yield* Oe(n, l(i, "agent-docs"), l(r, "agent-docs")));
-	let w = new Map((t.appTemplates ?? []).map((e) => [d(e.dir), e.template])), T = (e) => {
-		let t = w.get(d(e));
-		return t ? Pe(t, s, u) : "";
-	}, E = (e, t) => v.forEach(Se, (r) => Re(n, l(e, r), t, f));
-	for (let e of h) C.push(...yield* E(e, Fe.api(u, _.get(e) ?? null, T(e)))), (yield* W(n, l(e, "database"))) && C.push(...yield* E(l(e, "database"), Fe.database(u)));
-	for (let e of g) C.push(...yield* E(e, Fe.web(u, T(e))));
-	for (let e of Ie) C.push(yield* Re(n, l(r, ".claude", "skills", e.name, "SKILL.md"), Le(e, u), f));
+	let b = t.plugins ? t.plugins.map(Ae).filter((e) => e !== null) : y ? [...v] : null, S = a.includes(Ee) ? a.replace(Ee, Pe(s, b, l)) : a, C = [];
+	for (let e of d) C.push(yield* ze(n, e, S, u));
+	c || (yield* ke(n, f(i, "agent-docs"), f(r, "agent-docs")));
+	let w = new Map((t.appTemplates ?? []).map((e) => [m(e.dir), e.template])), T = (e) => {
+		let t = w.get(m(e));
+		return t ? Fe(t, s, l) : "";
+	}, E = (e, t) => x.forEach(Ce, (r) => ze(n, f(e, r), t, u));
+	for (let e of p) C.push(...yield* E(e, Ie.api(l, g.get(e) ?? null, T(e)))), (yield* K(n, f(e, "database"))) && C.push(...yield* E(f(e, "database"), Ie.database(l)));
+	for (let e of h) C.push(...yield* E(e, Ie.web(l, T(e))));
+	for (let e of Le) C.push(yield* ze(n, f(r, ".claude", "skills", e.name, "SKILL.md"), Re(e, l), u));
 	return { files: C };
-}), Be = (e, t = {}) => v.runPromise(ze(e, t).pipe(v.provide(h.layer))), Ve = async (e) => {
+}), Ve = (e, t = {}) => x.runPromise(Be(e, t).pipe(x.provide(v.layer))), He = async (e) => {
 	let t = e.includes("--force"), n = e.find((e) => !e.startsWith("-")) ?? process.cwd();
-	return V(v.gen(function* () {
-		let e = yield* ze(n, { force: t });
+	return be(x.gen(function* () {
+		let e = yield* Be(n, { force: t });
 		for (let t of e.files) {
-			let e = t.action === "created" ? "wrote" : t.action === "overwritten" ? "overwrote" : t.action === "protected" ? `protected (hand-maintained — has "${Ce}")` : "present (use --force to overwrite)";
-			yield* v.logInfo(`${t.path.split("/").slice(-2).join("/")} ${e}`, { action: t.action });
+			let e = t.action === "created" ? "wrote" : t.action === "overwritten" ? "overwrote" : t.action === "protected" ? `protected (hand-maintained — has "${we}")` : "present (use --force to overwrite)";
+			yield* x.logInfo(`${t.path.split("/").slice(-2).join("/")} ${e}`, { action: t.action });
 		}
 		return 0;
-	}).pipe(v.catchTag("TemplateNotFoundError", (e) => v.gen(function* () {
-		return yield* v.logError("AGENTS.md template not found", { searched: e.searched }), 1;
+	}).pipe(x.catchTag("TemplateNotFoundError", (e) => x.gen(function* () {
+		return yield* x.logError("AGENTS.md template not found", { searched: e.searched }), 1;
 	}))), { scope: "voltro:agents-md" });
-}, He = (e) => e.replace(/\\"|"(?:[^"\\]|\\.)*"|(\/\/[^\n]*|\/\*[\s\S]*?\*\/)/g, (e, t) => t ? "" : e), Ue = (e) => {
+}, Ue = (e) => e.replace(/\\"|"(?:[^"\\]|\\.)*"|(\/\/[^\n]*|\/\*[\s\S]*?\*\/)/g, (e, t) => t ? "" : e), We = (e) => {
 	try {
-		let t = l(e, "tsconfig.json");
-		if (!T(t)) return [];
-		let n = JSON.parse(He(k(t, "utf8"))).compilerOptions ?? {}, r = n.paths ?? {}, i = d(e, n.baseUrl ?? "."), a = [];
+		let t = f(e, "tsconfig.json");
+		if (!O(t)) return [];
+		let n = JSON.parse(Ue(M(t, "utf8"))).compilerOptions ?? {}, r = n.paths ?? {}, i = m(e, n.baseUrl ?? "."), a = [];
 		for (let [e, t] of Object.entries(r)) {
 			let n = t[0];
 			if (!n) continue;
@@ -340,28 +341,28 @@ boundary, naming, anti-patterns) before editing.
 				let t = e.slice(0, -2).replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 				a.push({
 					find: RegExp(`^${t}/(.*)$`),
-					replacement: `${l(i, n.slice(0, -2))}/$1`
+					replacement: `${f(i, n.slice(0, -2))}/$1`
 				});
 			} else a.push({
 				find: e,
-				replacement: l(i, n)
+				replacement: f(i, n)
 			});
 		}
 		return a;
 	} catch {
 		return [];
 	}
-}, We = (e) => {
+}, Ge = (e) => {
 	let t = e;
 	return t?.code === "ERR_MODULE_NOT_FOUND" || /Cannot find (package|module)/.test(String(t?.message ?? ""));
-}, Ge = async (e, t) => {
+}, Ke = async (e, t) => {
 	try {
 		return await t();
 	} catch (t) {
-		throw We(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 Ge(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;
 	}
-}, Ke = "// 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, Je = (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"), Ye = async (e, t) => {
-	let n = Je(t, () => !0), r = `${Ke}
+}, qe = "// AUTO-GENERATED by Voltro — DO NOT EDIT.\n// Source: app.config.ts `env` (defineEnv). Regenerated on every `voltro dev` boot.\n", Je = (e, t) => t ? `${e} | undefined` : e, Ye = (e, t) => Object.entries(e.vars).filter(([, e]) => t(e.access)).map(([e, t]) => `${t.description ? `    /** ${t.description} */\n` : ""}    readonly ${e}: ${Je(t.tsType, t.optional)}`).join("\n"), Xe = async (e, t) => {
+	let n = Ye(t, () => !0), r = `${qe}
 import '@voltro/env/server'
 
 declare module '@voltro/env/server' {
@@ -370,9 +371,9 @@ ${n.length > 0 ? n : "    // (no variables declared)"}
   }
 }
 `;
-	await B(l(e, "env.generated.d.ts"), r, "utf8");
-}, Xe = async (e, t) => {
-	let n = Je(t, (e) => e === "public"), r = `${Ke}
+	await V(f(e, "env.generated.d.ts"), r, "utf8");
+}, Ze = async (e, t) => {
+	let n = Ye(t, (e) => e === "public"), r = `${qe}
 import '@voltro/env/public'
 
 declare module '@voltro/env/public' {
@@ -380,10 +381,10 @@ declare module '@voltro/env/public' {
 ${n.length > 0 ? n : "    // (no public variables declared)"}
   }
 }
-`, i = l(e, "src");
-	await de(i, { recursive: !0 }), await B(l(i, "voltro-env.d.ts"), r, "utf8");
-}, Ze = async (e, t) => {
-	let n = `${Ke}
+`, i = f(e, "src");
+	await B(i, { recursive: !0 }), await V(f(i, "voltro-env.d.ts"), r, "utf8");
+}, Qe = async (e, t) => {
+	let n = `${qe}
 import { __installPublicEnv } from '@voltro/env/public'
 
 export const publicEnvValues = ${JSON.stringify(t, null, 2)} as const
@@ -391,14 +392,14 @@ export const publicEnvValues = ${JSON.stringify(t, null, 2)} as const
 // Set the browser/SSR-shared global the \`publicEnv\` accessor reads.
 __installPublicEnv(publicEnvValues)
 `;
-	await de(e, { recursive: !0 }), await B(l(e, "env.public.ts"), n, "utf8");
-}, Qe = async (e) => {
-	let t = se(e.rawEnv) ? e.rawEnv : void 0, n = await z({
+	await B(e, { recursive: !0 }), await V(f(e, "env.public.ts"), n, "utf8");
+}, $e = async (e) => {
+	let t = le(e.rawEnv) ? e.rawEnv : void 0, n = await fe({
 		contract: t,
-		resolveSecret: I
-	}), r = [...n.errors, ...ie(t, e.appType)];
-	if (r.length > 0) throw Error(ae(r));
-	oe(n.values), e.appType === "web" && ue(n.publicValues);
+		resolveSecret: ne
+	}), r = [...n.errors, ...se(t, e.appType)];
+	if (r.length > 0) throw Error(ce(r));
+	z(n.values), e.appType === "web" && pe(n.publicValues);
 	let i = t ? Object.keys(t.vars).length : 0;
 	if (i > 0) {
 		let r = Object.keys(n.publicValues).length;
@@ -410,20 +411,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 Ye(e.root, t) : await Xe(e.root, t)), {
+	return e.generateTypes && t && (e.appType === "api" ? await Xe(e.root, t) : await Ze(e.root, t)), {
 		resolved: n,
 		contract: t
 	};
-}, $e = (e) => {
-	let t = re(e.contract), n = (e.plugins ?? []).flatMap((e) => ce(e.name, e.declaredEnv)), r = e.includeFramework === !1 ? [] : ne, i = /* @__PURE__ */ new Set(), a = [];
+}, et = (e) => {
+	let t = oe(e.contract), n = (e.plugins ?? []).flatMap((e) => ue(e.name, e.declaredEnv)), r = e.includeFramework === !1 ? [] : ae, 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;
-}, et = (e, t, n = (e) => process.env[e]) => {
-	let r = $e(t).map((e) => {
+}, tt = (e, t, n = (e) => process.env[e]) => {
+	let r = et(t).map((e) => {
 		let t = n(e.key) !== void 0;
 		return {
 			...e,
@@ -440,13 +441,13 @@ __installPublicEnv(publicEnvValues)
 			missingRequired: r.filter((e) => e.required && !e.isSet && e.default === void 0).length
 		}
 	};
-}, tt = (e, t) => le($e({
+}, nt = (e, t) => de(et({
 	...e,
 	includeFramework: !1
 }), {
 	includeFramework: e.includeFramework !== !1,
 	...t ? { header: t } : {}
-}), nt = () => {
+}), rt = () => {
 	let e = /* @__PURE__ */ new Map();
 	return {
 		get(t) {
@@ -473,7 +474,7 @@ __installPublicEnv(publicEnvValues)
 			return Array.from(e.entries());
 		}
 	};
-}, K = (e) => {
+}, J = (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);
@@ -482,24 +483,33 @@ __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;
-}, rt = (e, t = {}) => {
+}, it = (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("|");
-}, it = (e, t) => e.expiresAt > t, at = (e, t) => e.expiresAt <= t && e.servableUntil > t, ot = S({ scope: "voltro:cli" }), st = [], ct = (e) => {
-	st.length = 0;
-	let t = e[1] && !e[1].startsWith("-") ? e[1] : void 0, n = t ? c(t) ? t : d(process.cwd(), t) : process.cwd(), r = [], i = n;
+}, at = (e, t) => e.expiresAt > t, ot = (e, t) => e.expiresAt <= t && e.servableUntil > t, st = T({ scope: "voltro:cli" }), ct = (e, t) => {
+	if (t?.code !== "EACCES") return "";
+	if (typeof process.getuid != "function") return " — permission denied";
+	try {
+		let t = P(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)";
+	}
+}, lt = [], ut = (e) => {
+	lt.length = 0;
+	let t = e[1] && !e[1].startsWith("-") ? e[1] : void 0, n = t ? d(t) ? t : m(process.cwd(), t) : process.cwd(), r = [], i = n;
 	for (;;) {
 		r.push(i);
-		let e = s(i);
+		let e = u(i);
 		if (e === i) break;
 		i = e;
 	}
 	for (let e of r) for (let t of [".env.local", ".env"]) {
-		let n = d(e, t);
-		if (T(n)) {
-			st.push(n);
+		let n = m(e, t);
+		if (O(n)) {
+			lt.push(n);
 			try {
-				let e = k(n, "utf8");
+				let e = M(n, "utf8");
 				for (let t of e.split(/\r?\n/)) {
 					let e = t.trim();
 					if (e === "" || e.startsWith("#")) continue;
@@ -509,15 +519,15 @@ __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) {
-				ot.warn("failed to load env file (continuing)", { path: n }, e);
+				st.warn(`failed to load env file (continuing)${ct(n, e)}`, { path: n }, e);
 			}
 		}
 	}
-}, lt = 500, ut = (e, t, n = {}) => {
+}, dt = 500, ft = (e, t, n = {}) => {
 	if (e.length === 0) return () => {};
-	let r = (e) => n.root ? u(n.root, e) : e, i = !1, a = (e) => {
+	let r = (e) => n.root ? p(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(() => {
-			let e = me(process.execPath, [...process.execArgv, ...process.argv.slice(1)], {
+			let e = ge(process.execPath, [...process.execArgv, ...process.argv.slice(1)], {
 				stdio: "inherit",
 				env: process.env,
 				cwd: n.cwd ?? process.cwd()
@@ -531,62 +541,62 @@ __installPublicEnv(publicEnvValues)
 			});
 		}));
 	};
-	for (let t of e) P(t, { interval: lt }, (e, n) => {
+	for (let t of e) te(t, { interval: dt }, (e, n) => {
 		e.mtimeMs !== n.mtimeMs && a(t);
 	});
 	return t.info("watching .env files for changes", {
 		files: e.map(r),
-		intervalMs: lt
+		intervalMs: dt
 	}), () => {
-		for (let t of e) N(t);
+		for (let t of e) F(t);
 	};
-}, q = S({ scope: "vite" }), dt = /\x1b\[[0-9;]*m/g, ft = /^\s*\[?vite\]?\s*(\([a-z-]+\)\s*)?/, pt = (e) => e.replace(dt, "").replace(ft, "").trim(), mt = /proxy error/i, ht = [
+}, pt = T({ scope: "vite" }), mt = /\x1b\[[0-9;]*m/g, ht = /^\s*\[?vite\]?\s*(\([a-z-]+\)\s*)?/, gt = (e) => e.replace(mt, "").replace(ht, "").trim(), _t = /proxy error/i, vt = [
 	"ECONNREFUSED",
 	"ECONNRESET",
 	"ECONNABORTED",
 	"EPIPE",
 	"ETIMEDOUT"
-], gt = (e, t = 0) => {
+], yt = (e, t = 0) => {
 	if (e == null || t > 5) return !1;
 	let n = e;
-	return typeof n.code == "string" && ht.includes(n.code) || typeof n.message == "string" && ht.some((e) => n.message.includes(e)) || Array.isArray(n.errors) && n.errors.some((e) => gt(e, t + 1)) ? !0 : gt(n.cause, t + 1);
-}, _t = 4e3, vt = () => {
+	return typeof n.code == "string" && vt.includes(n.code) || typeof n.message == "string" && vt.some((e) => n.message.includes(e)) || Array.isArray(n.errors) && n.errors.some((e) => yt(e, t + 1)) ? !0 : yt(n.cause, t + 1);
+}, bt = 4e3, xt = () => {
 	let e = /* @__PURE__ */ new Set(), t = 0, n = {
 		hasWarned: !1,
 		info: (e) => {
-			let t = pt(e);
-			t.length !== 0 && q.info(t);
+			let t = gt(e);
+			t.length !== 0 && pt.info(t);
 		},
 		warn: (e) => {
 			n.hasWarned = !0;
-			let t = pt(e);
-			t.length !== 0 && q.warn(t);
+			let t = gt(e);
+			t.length !== 0 && pt.warn(t);
 		},
 		warnOnce: (t) => {
-			let r = pt(t);
-			e.has(r) || (e.add(r), n.hasWarned = !0, r.length !== 0 && q.warn(r));
+			let r = gt(t);
+			e.has(r) || (e.add(r), n.hasWarned = !0, r.length !== 0 && pt.warn(r));
 		},
 		error: (e, n) => {
-			let r = pt(e), i = n?.error;
+			let r = gt(e), i = n?.error;
 			if (r.length !== 0) {
-				if (mt.test(r) && gt(i)) {
+				if (_t.test(r) && yt(i)) {
 					let e = Date.now();
-					e - t > _t && (t = e, q.info("waiting for api — proxy upstream not accepting connections yet (still starting?)"));
+					e - t > bt && (t = e, pt.info("waiting for api — proxy upstream not accepting connections yet (still starting?)"));
 					return;
 				}
-				q.error(r, {}, i);
+				pt.error(r, {}, i);
 			}
 		},
 		clearScreen: () => {},
 		hasErrorLogged: (e) => !1
 	};
 	return n;
-}, yt = (e = process.env) => {
+}, St = (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;
-}, bt = (e) => {
+}, Ct = (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--;
@@ -604,8 +614,8 @@ __installPublicEnv(publicEnvValues)
 			return n;
 		}
 	};
-}, xt = (e) => {
-	let t = bt(e.limit), n = /* @__PURE__ */ new Map(), r = /* @__PURE__ */ new Set();
+}, wt = (e) => {
+	let t = Ct(e.limit), n = /* @__PURE__ */ new Map(), r = /* @__PURE__ */ new Set();
 	return {
 		load: (i, a) => {
 			if (r.has(i)) return a();
@@ -630,7 +640,7 @@ __installPublicEnv(publicEnvValues)
 			return r.size;
 		}
 	};
-}, St = (e) => {
+}, Tt = (e) => {
 	let t = [];
 	for (let n of e.split("/").filter(Boolean)) n.startsWith("[[...") && n.endsWith("]]") ? t.push({
 		name: n.slice(5, -2),
@@ -646,12 +656,12 @@ __installPublicEnv(publicEnvValues)
 		optional: !1
 	});
 	return t;
-}, Ct = (e) => e.replace(/-([a-z0-9])/g, (e, t) => t.toUpperCase()), wt = async (e) => {
-	let t = d(e);
+}, Et = (e) => e.replace(/-([a-z0-9])/g, (e, t) => t.toUpperCase()), Dt = async (e) => {
+	let t = m(e);
 	for (let e = 0; e < 4; e++) {
-		let e = l(t, "project.json");
-		if (T(e)) try {
-			let n = await O.readFile(e, "utf8");
+		let e = f(t, "project.json");
+		if (O(e)) try {
+			let n = await j.readFile(e, "utf8");
 			return {
 				projectDir: t,
 				manifest: JSON.parse(n)
@@ -659,38 +669,38 @@ __installPublicEnv(publicEnvValues)
 		} catch {
 			return null;
 		}
-		let n = s(t);
+		let n = u(t);
 		if (n === t) break;
 		t = n;
 	}
 	return null;
-}, Tt = async (e) => {
-	let t = await wt(e);
+}, Ot = async (e) => {
+	let t = await Dt(e);
 	if (!t) return [];
-	let { projectDir: n, manifest: r } = t, i = o(e), a = r.apps ?? {}, s = [];
+	let { projectDir: n, manifest: r } = t, i = l(e), a = r.apps ?? {}, o = [];
 	for (let [e, t] of Object.entries(a)) {
 		if (e === i || t.kind !== "web" || typeof t.port != "number") continue;
-		let r = l(l(n, t.path ?? e), "src", "pages");
-		if (!T(r)) continue;
+		let r = f(f(n, t.path ?? e), "src", "pages");
+		if (!O(r)) continue;
 		let a;
 		try {
 			let { pages: e } = await $(r);
 			a = e.map((e) => ({
 				pattern: e.pattern,
-				params: St(e.pattern)
+				params: Tt(e.pattern)
 			}));
 		} catch {
 			continue;
 		}
-		s.push({
-			key: Ct(e),
+		o.push({
+			key: Et(e),
 			origin: `http://localhost:${t.port}`,
 			...typeof t.origin == "string" && t.origin.length > 0 ? { prodOrigin: t.origin } : {},
 			routes: a
 		});
 	}
-	return s;
-}, Et = (e) => {
+	return o;
+}, kt = (e) => {
 	if (e.params.length === 0) return `'${e.pattern}'`;
 	let t = e.pattern;
 	for (let n of e.params) {
@@ -698,21 +708,21 @@ __installPublicEnv(publicEnvValues)
 		t = t.replace(e, r);
 	}
 	return "`" + t + "`";
-}, Dt = (e) => e.params.length === 0 ? "EmptyParams" : `{ ${e.params.map((e) => {
+}, At = (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("; ")} }`, Ot = (e, t, n) => {
-	let r = Dt(e), i = Et(e), a = t ? "VoltroExternalUrl" : "VoltroRouteUrl", o = t && n ? `${n} + ` : "";
+}).join("; ")} }`, jt = (e, t, n) => {
+	let r = At(e), i = kt(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}`;
-}, kt = (e) => `{\n${[...e].sort((e, t) => e.pattern.localeCompare(t.pattern)).map((e) => `  ${JSON.stringify(e.pattern)}: ${Ot(e, !1)},`).join("\n")}\n}`, At = (e, t) => {
+}, Mt = (e) => `{\n${[...e].sort((e, t) => e.pattern.localeCompare(t.pattern)).map((e) => `  ${JSON.stringify(e.pattern)}: ${jt(e, !1)},`).join("\n")}\n}`, Nt = (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)}: ${Ot(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)}: ${jt(e, !0, i)},`);
 	return `  ${e.key}: {\n${a.join("\n")}\n  },`;
-}, jt = async (e) => {
+}, Pt = async (e) => {
 	let t = e.pages.map((e) => ({
 		pattern: e.pattern,
-		params: St(e.pattern)
-	})), n = await Tt(e.appRoot), r = [
+		params: Tt(e.pattern)
+	})), n = await Ot(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={...}>.",
@@ -721,20 +731,20 @@ __installPublicEnv(publicEnvValues)
 		"",
 		"type EmptyParams = Record<string, never>",
 		""
-	].join("\n"), i = e.mode ?? "dev", a = `${r}\n${`export const routes = ${kt(t)} as const\n`}\n${n.length === 0 ? "export const siblingApps = {} as Record<string, never>\n" : `export const siblingApps = {\n${n.map((e) => At(e, i)).join("\n")}\n} as const\n`}`, o = l(e.appRoot, ".framework", "routes.generated.ts");
-	await O.mkdir(s(o), { recursive: !0 });
-	let c = null;
+	].join("\n"), i = e.mode ?? "dev", a = `${r}\n${`export const routes = ${Mt(t)} as const\n`}\n${n.length === 0 ? "export const siblingApps = {} as Record<string, never>\n" : `export const siblingApps = {\n${n.map((e) => Nt(e, i)).join("\n")}\n} as const\n`}`, o = f(e.appRoot, ".framework", "routes.generated.ts");
+	await j.mkdir(u(o), { recursive: !0 });
+	let s = null;
 	try {
-		c = await O.readFile(o, "utf8");
+		s = await j.readFile(o, "utf8");
 	} catch {}
-	return c === a ? {
+	return s === a ? {
 		path: o,
 		wrote: !1
-	} : (await O.writeFile(o, a, "utf8"), {
+	} : (await j.writeFile(o, a, "utf8"), {
 		path: o,
 		wrote: !0
 	});
-}, Mt = 256, Nt = (e = Mt) => {
+}, Ft = 256, It = (e = Ft) => {
 	let t = [], n = /* @__PURE__ */ new Set();
 	return {
 		emit(r, i) {
@@ -757,27 +767,27 @@ __installPublicEnv(publicEnvValues)
 			return t.slice();
 		}
 	};
-}, Pt = (e) => `event: ${e.channel}\ndata: ${JSON.stringify(e)}\n\n`, Ft = () => `: keep-alive ${Date.now()}\n\n`, It = {
+}, Lt = (e) => `event: ${e.channel}\ndata: ${JSON.stringify(e)}\n\n`, Rt = () => `: keep-alive ${Date.now()}\n\n`, zt = {
 	trace: 0,
 	debug: 1,
 	info: 2,
 	warn: 3,
 	error: 4,
 	fatal: 5
-}, Lt = 2e3, Rt = 200, zt = class {
+}, Bt = 2e3, Vt = 200, Ht = class {
 	capacity;
 	buffer = [];
-	constructor(e = Lt) {
+	constructor(e = Bt) {
 		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 ?? Rt, this.capacity), i = e.minLevel === void 0 ? It.trace : It[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 ?? Vt, this.capacity), i = e.minLevel === void 0 ? zt.trace : zt[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 || It[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 || zt[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();
 	}
@@ -790,7 +800,7 @@ __installPublicEnv(publicEnvValues)
 	clear() {
 		this.buffer = [];
 	}
-}, Bt = null, Vt = () => (Bt === null && (Bt = new zt()), Bt), Ht = (e) => {
+}, Ut = null, Wt = () => (Ut === null && (Ut = new Ht()), Ut), Gt = (e) => {
 	if (typeof e == "string") return e;
 	if (e instanceof Error) return e.message;
 	try {
@@ -798,18 +808,18 @@ __installPublicEnv(publicEnvValues)
 	} catch {
 		return String(e);
 	}
-}, Ut = (e) => {
+}, Kt = (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 = Vt(), r = !1, i = (i) => (...a) => {
+	}, n = Wt(), r = !1, i = (i) => (...a) => {
 		if (t[i](...a), !r) {
 			r = !0;
 			try {
-				let t = a.length > 0 ? Ht(a[0]) : "", r = t.length > 500 ? t.slice(0, 500) + "…" : t, o = F();
+				let t = a.length > 0 ? Gt(a[0]) : "", r = t.length > 500 ? t.slice(0, 500) + "…" : t, o = L();
 				e.emit("log", {
 					level: i,
 					message: r,
@@ -836,7 +846,7 @@ __installPublicEnv(publicEnvValues)
 		}
 	};
 	console.log = i("log"), console.info = i("info"), console.warn = i("warn"), console.error = i("error"), console.debug = i("debug");
-	let a = x((t) => {
+	let a = w((t) => {
 		if (!r) {
 			r = !0;
 			try {
@@ -847,7 +857,7 @@ __installPublicEnv(publicEnvValues)
 					argsCount: 1,
 					...t.scope === void 0 ? {} : { scope: t.scope }
 				});
-				let a = F(), o = a !== void 0 && t.fields.traceId === void 0 ? {
+				let a = L(), o = a !== void 0 && t.fields.traceId === void 0 ? {
 					...t.fields,
 					traceId: a.traceId
 				} : t.fields;
@@ -867,24 +877,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();
 	};
-}, Wt = 2e3, Gt = 8, Kt = 1e3, qt = 200, J = (e, t) => e.length > t ? `${e.slice(0, t)}…` : e, Jt = (e) => {
+}, qt = 2e3, Jt = 8, Yt = 1e3, Xt = 200, Y = (e, t) => e.length > t ? `${e.slice(0, t)}…` : e, Zt = (e) => {
 	switch (e) {
 		case "error": return "error";
 		case "warn": return "warn";
 		case "debug": return "debug";
 		default: return "info";
 	}
-}, Yt = S({ scope: "client" }), Xt = (e, t) => {
+}, Qt = T({ scope: "client" }), $t = (e, t) => {
 	let n;
 	try {
 		n = JSON.parse(e);
 	} catch {
-		return Zt(400, { error: "invalid JSON body" });
+		return en(400, { error: "invalid JSON body" });
 	}
-	if (typeof n != "object" || !n) return Zt(400, { error: "body must be a JSON object" });
+	if (typeof n != "object" || !n) return en(400, { error: "body must be a JSON object" });
 	let r = n;
-	if (!Array.isArray(r.entries)) return Zt(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, qt), c = 0;
+	if (!Array.isArray(r.entries)) return en(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, Xt), c = 0;
 	for (let e of s) {
 		if (typeof e != "object" || !e) continue;
 		let n = e;
@@ -895,7 +905,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 = J(n.message, Wt), u = Array.isArray(n.args) ? n.args.slice(0, Gt).filter((e) => typeof e == "string").map((e) => J(e, Kt)) : void 0, d = typeof n.stack == "string" ? J(n.stack, Wt) : void 0;
+		].includes(n.level) ? n.level : "log", s = typeof n.ts == "number" && Number.isFinite(n.ts) ? n.ts : Date.now(), l = Y(n.message, qt), u = Array.isArray(n.args) ? n.args.slice(0, Jt).filter((e) => typeof e == "string").map((e) => Y(e, Yt)) : void 0, d = typeof n.stack == "string" ? Y(n.stack, qt) : void 0;
 		t.emit("clientLog", {
 			ts: s,
 			level: r,
@@ -910,50 +920,50 @@ __installPublicEnv(publicEnvValues)
 			...i === void 0 ? {} : { app: i },
 			...a === void 0 ? {} : { page: a },
 			...u !== void 0 && u.length > 0 ? { args: u } : {}
-		}, p = Jt(r);
-		(p === "error" || p === "warn") && d !== void 0 ? Yt[p](l, f, { stack: d }) : Yt[p](l, {
+		}, p = Zt(r);
+		(p === "error" || p === "warn") && d !== void 0 ? Qt[p](l, f, { stack: d }) : Qt[p](l, {
 			...f,
 			...d === void 0 ? {} : { stack: d }
 		}), c++;
 	}
-	return Zt(202, {
+	return en(202, {
 		accepted: c,
 		dropped: r.entries.length - c
 	});
-}, Zt = (e, t) => ({
+}, en = (e, t) => ({
 	status: e,
 	contentType: "application/json; charset=utf-8",
 	body: JSON.stringify(t)
-}), Qt = "/_voltro/inspect/clientLog", $t = [
+}), tn = "/_voltro/inspect/clientLog", nn = [
 	"trace",
 	"debug",
 	"info",
 	"warn",
 	"error",
 	"fatal"
-], en = {
+], rn = {
 	trace: "TRACE",
 	debug: "DEBUG",
 	info: "INFO ",
 	warn: "WARN ",
 	error: "ERROR",
 	fatal: "FATAL"
-}, tn = (e) => $t.includes(e), nn = (e, n, i = {}) => {
-	if (t()) return {
+}, an = (e) => nn.includes(e), on = (e, t, n = {}) => {
+	if (i()) return {
 		status: 503,
 		contentType: "application/json",
 		body: JSON.stringify({ error: "inspect disabled (VOLTRO_INSPECT=off)" })
 	};
-	let a = r(i);
-	if (!a.ok) return {
+	let r = o(n);
+	if (!r.ok) return {
 		status: 401,
 		contentType: "application/json",
 		body: JSON.stringify({
 			error: "unauthorized",
-			reason: a.reason
+			reason: r.reason
 		})
 	};
-	let o = e.indexOf("?"), s = o === -1 ? new URLSearchParams() : new URLSearchParams(e.slice(o + 1)), c = {}, l = s.get("since");
+	let a = e.indexOf("?"), s = a === -1 ? new URLSearchParams() : new URLSearchParams(e.slice(a + 1)), c = {}, l = s.get("since");
 	if (l !== null) {
 		let e = Number(l);
 		Number.isFinite(e) && (c.since = e);
@@ -969,7 +979,7 @@ __installPublicEnv(publicEnvValues)
 		Number.isFinite(e) && e > 0 && (c.max = Math.floor(e));
 	}
 	let f = s.get("level");
-	f !== null && tn(f) && (c.minLevel = f);
+	f !== null && an(f) && (c.minLevel = f);
 	let p = s.get("source");
 	(p === "server" || p === "client") && (c.source = p);
 	let m = s.get("scope");
@@ -978,16 +988,16 @@ __installPublicEnv(publicEnvValues)
 	h !== null && h.length > 0 && (c.filter = h);
 	let g = s.get("trace");
 	g !== null && g.length > 0 && (c.traceId = g);
-	let _ = n.query(c);
+	let _ = t.query(c);
 	if ((s.get("format") ?? "json") === "text") return {
 		status: 200,
 		contentType: "text/plain; charset=utf-8",
-		body: _.map(rn).join("\n") + (_.length > 0 ? "\n" : "")
+		body: _.map(sn).join("\n") + (_.length > 0 ? "\n" : "")
 	};
 	let v = {
 		capturedAt: Date.now(),
-		bufferCapacity: n.capacityHint(),
-		bufferSize: n.size(),
+		bufferCapacity: t.capacityHint(),
+		bufferSize: t.size(),
 		returned: _.length,
 		records: _
 	};
@@ -996,33 +1006,33 @@ __installPublicEnv(publicEnvValues)
 		contentType: "application/json; charset=utf-8",
 		body: JSON.stringify(v)
 	};
-}, rn = (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} ${en[e.level]} ${o} ${e.message}${s}`;
-}, an = 80, on = (e) => {
+}, sn = (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 = ln(e.fields);
+	return `${n}:${r}:${i}.${a} ${rn[e.level]} ${o} ${e.message}${s}`;
+}, cn = 80, ln = (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 = sn(r);
+		let t = un(r);
 		n.push(`${e}=${t}`);
 	}
 	return n.length > 0 ? "  " + n.join(" ") : "";
-}, sn = (e) => {
+}, un = (e) => {
 	if (typeof e == "string") {
-		let t = e.length > an ? e.slice(0, an) + "…" : e;
+		let t = e.length > cn ? e.slice(0, cn) + "…" : 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 > an ? t.slice(0, an) + "…" : t;
+		return t.length > cn ? t.slice(0, cn) + "…" : t;
 	} catch {
 		return "[unserialisable]";
 	}
-}, cn = "/_voltro/inspect/logs", ln = [{
+}, dn = "/_voltro/inspect/logs", fn = [{
 	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)\.?/);
@@ -1034,13 +1044,13 @@ __installPublicEnv(publicEnvValues)
 			});
 		} else t.info(n);
 	}
-}], un = () => {
+}], pn = () => {
 	let e = {
 		warn: console.warn.bind(console),
 		error: console.error.bind(console)
-	}, t = S({ scope: "babel" }), n = !1, r = (r) => (...i) => {
+	}, t = T({ scope: "babel" }), n = !1, r = (r) => (...i) => {
 		if (!n) {
-			for (let e of ln) if (e.match(i[0])) {
+			for (let e of fn) if (e.match(i[0])) {
 				n = !0;
 				try {
 					e.handle(i, t);
@@ -1055,7 +1065,7 @@ __installPublicEnv(publicEnvValues)
 	return console.warn = r("warn"), console.error = r("error"), () => {
 		console.warn = e.warn, console.error = e.error;
 	};
-}, dn = {
+}, mn = {
 	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",
@@ -1066,7 +1076,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(dn), pn = "virtual:voltro-route-refresh", mn = `\0${pn}`, hn = /(?:^|&)(raw|url|inline|worker|sharedworker|direct)(?:&|=|$)/, gn = () => `
+}, hn = Object.keys(mn), gn = (e) => n.test(e), _n = (e) => e.replace(t, ".page.test.tsx"), vn = (t) => t.endsWith(".tsx") && !e.has(t) && !gn(t), yn = "virtual:voltro-route-refresh", bn = `\0${yn}`, xn = /(?:^|&)(raw|url|inline|worker|sharedworker|direct)(?:&|=|$)/, Sn = () => `
 // GENERATED by @voltro/cli — the \`voltro dev\` route Fast Refresh runtime.
 
 /** Mirrors react-refresh's own \`isLikelyComponentType\` closely enough for the
@@ -1095,11 +1105,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(hn)}
 
 /** 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(dn)}
+const serverExportEffect = ${JSON.stringify(mn)}
 
 /** The reason \`name\` forces a reload, for the console line. */
 export const serverEffectOf = (name) =>
@@ -1142,7 +1152,7 @@ export const routeUpdateNeedsReload = (prevExports, nextExports) => {
 const previousHook = globalThis.__getReactRefreshIgnoredExports
 globalThis.__getReactRefreshIgnoredExports = (args) =>
   ignoredExports.get(args.id) ?? previousHook?.(args) ?? []
-`, _n = (e) => `
+`, Cn = (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.
@@ -1169,76 +1179,73 @@ import {
   registerRouteModule as __voltro_registerRouteModule,
   routeUpdateNeedsReload as __voltro_routeUpdateNeedsReload,
   serverEffectOf as __voltro_serverEffect,
-} from '${pn}'
-`, vn = (e) => e.replace(/\\/g, "/"), yn = (e, t) => {
-	let [n = "", r] = vn(e).split("?");
-	if (!n.endsWith(".tsx") || r !== void 0 && hn.test(r)) return !1;
-	let i = vn(t).replace(/\/$/, "");
-	return n.startsWith(`${i}/`);
-}, bn = (e, t, n) => yn(t, n) ? `${e}${_n(vn(t).split("?")[0] ?? t)}` : null, xn = (e) => ({
+} from '${yn}'
+`, wn = (e) => e.replace(/\\/g, "/"), Tn = (n, r) => {
+	let [i = "", a] = wn(n).split("?");
+	if (!i.endsWith(".tsx") || a !== void 0 && xn.test(a)) return !1;
+	let o = wn(r).replace(/\/$/, "");
+	return i.startsWith(`${o}/`) ? t.test(i) || e.has(i.slice(i.lastIndexOf("/") + 1)) : !1;
+}, En = (e, t, n) => Tn(t, n) ? `${e}${Cn(wn(t).split("?")[0] ?? t)}` : null, Dn = (e) => ({
 	name: "voltro:route-fast-refresh",
 	enforce: "pre",
-	resolveId: (e) => e === "virtual:voltro-route-refresh" ? mn : void 0,
-	load: (e) => e === mn ? gn() : void 0,
+	resolveId: (e) => e === "virtual:voltro-route-refresh" ? bn : void 0,
+	load: (e) => e === bn ? Sn() : void 0,
 	transform: (t, n, r) => {
 		if (r?.ssr === !0) return null;
-		let i = bn(t, n, e);
+		let i = En(t, n, e);
 		return i === null ? null : {
 			code: i,
 			map: null
 		};
 	}
-}), Sn = [
+}), On = [
 	"static",
 	"spa",
 	"ssr",
 	"isr"
-], Cn = (e) => typeof e == "string" && Sn.includes(e), wn = Sn.map((e) => `'${e}'`).join(" | "), Tn = (e, t) => `[voltro] ${e}: unknown renderMode '${t}'.\n  Valid values: ${wn}.${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)." : ""}`, En = class extends Error {
+], kn = (e) => typeof e == "string" && On.includes(e), An = On.map((e) => `'${e}'`).join(" | "), jn = (e, t) => `[voltro] ${e}: unknown renderMode '${t}'.\n  Valid values: ${An}.${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)." : ""}`, Mn = class extends Error {
 	page;
 	value;
 	name = "InvalidRenderModeError";
 	constructor(e, t) {
-		super(Tn(e, t)), this.page = e, this.value = t;
+		super(jn(e, t)), this.page = e, this.value = t;
 	}
-}, Dn = (e, t = "<page>") => {
+}, Nn = (e, t = "<page>") => {
 	if (e.renderMode !== void 0 && e.renderMode !== null) {
-		if (!Cn(e.renderMode)) throw new En(t, String(e.renderMode));
+		if (!kn(e.renderMode)) throw new Mn(t, String(e.renderMode));
 		return e.renderMode;
 	}
 	return e.dynamic === "force-dynamic" ? "ssr" : (e.dynamic, "static");
-}, On = (e, t = "<page>") => ({
-	renderMode: Dn(e, t),
+}, Pn = (e, t = "<page>") => ({
+	renderMode: Nn(e, t),
 	tenantAware: e.tenantAware === !0,
-	revalidateMs: K(e.revalidate),
-	staleWhileRevalidateMs: K(e.staleWhileRevalidate) ?? 0,
+	revalidateMs: J(e.revalidate),
+	staleWhileRevalidateMs: J(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"
-}), kn = /export\s+const\s+renderMode\s*(?::[^=]+)?=\s*['"]([^'"]*)['"]/, An = (e) => kn.exec(e)?.[1] ?? null, jn = async (e, t) => {
+}), Fn = /export\s+const\s+renderMode\s*(?::[^=]+)?=\s*['"]([^'"]*)['"]/, In = (e) => Fn.exec(e)?.[1] ?? null, Ln = /export\s+default\b|export\s*\{[^}]*\bas\s+default\b/, Rn = async (e, t) => {
 	let n = (await Promise.all(t.map(async (t) => {
 		let n;
 		try {
-			n = await fe(l(e, t.file), "utf8");
+			n = await me(f(e, t.file), "utf8");
 		} catch {
 			return null;
 		}
-		let r = An(n);
-		return r === null || Cn(r) ? null : {
-			file: t.file,
-			value: r
-		};
+		let r = In(n);
+		return r !== null && !kn(r) ? jn(f("src", "pages", t.file), r) : Ln.test(n) ? null : `${f("src", "pages", t.file)} is a route (it ends in .page.tsx) 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 — if this file is NOT a route —\n  drop the .page suffix. Anything under src/pages/ without it is ordinary code and may\n  live beside the page that uses it.`;
 	}))).filter((e) => e !== null);
-	if (n.length !== 0) throw Error(n.map((e) => Tn(l("src", "pages", e.file), e.value)).join("\n\n"));
-}, Mn = l(R(), ".voltro"), Nn = l(Mn, "runtime-registry.json"), Pn = 3e4, Fn = () => {
+	if (n.length !== 0) throw Error(n.join("\n\n"));
+}, zn = f(ie(), ".voltro"), Bn = f(zn, "runtime-registry.json"), Vn = 3e4, Hn = () => {
 	let e = Math.random().toString(36).slice(2, 10);
-	return `${Nn}.${process.pid}.${Date.now()}.${e}.tmp`;
-}, In = async () => {
-	await O.mkdir(Mn, { recursive: !0 });
-}, Ln = async () => {
+	return `${Bn}.${process.pid}.${Date.now()}.${e}.tmp`;
+}, Un = async () => {
+	await j.mkdir(zn, { recursive: !0 });
+}, Wn = async () => {
 	try {
-		let e = await O.readFile(Nn, "utf8"), t = JSON.parse(e);
+		let e = await j.readFile(Bn, "utf8"), t = JSON.parse(e);
 		return t.version !== 1 || !Array.isArray(t.apps) ? {
 			version: 1,
 			apps: []
@@ -1249,34 +1256,34 @@ import {
 			apps: []
 		};
 	}
-}, Rn = async (e) => {
-	await In();
-	let t = Fn();
+}, Gn = async (e) => {
+	await Un();
+	let t = Hn();
 	try {
-		await O.writeFile(t, JSON.stringify(e, null, 2), {
+		await j.writeFile(t, JSON.stringify(e, null, 2), {
 			encoding: "utf8",
 			mode: 384
-		}), await O.rename(t, Nn), await O.chmod(Nn, 384).catch(() => {});
+		}), await j.rename(t, Bn), await j.chmod(Bn, 384).catch(() => {});
 	} catch (e) {
 		try {
-			await O.unlink(t);
+			await j.unlink(t);
 		} catch {}
 		throw e;
 	}
-}, zn = (e) => {
+}, Kn = (e) => {
 	try {
 		return process.kill(e, 0), !0;
 	} catch {
 		return !1;
 	}
-}, Bn = (e) => {
+}, qn = (e) => {
 	let t = Date.now();
-	return e.filter((e) => zn(e.pid) ? t - new Date(e.heartbeatAt).getTime() < Pn : !1);
-}, Vn = async () => {
-	let e = await Ln(), t = Bn(e.apps);
+	return e.filter((e) => Kn(e.pid) ? t - new Date(e.heartbeatAt).getTime() < Vn : !1);
+}, Jn = async () => {
+	let e = await Wn(), t = qn(e.apps);
 	if (t.length === e.apps.length) return e;
 	try {
-		await Rn({
+		await Gn({
 			version: 1,
 			apps: t
 		});
@@ -1285,49 +1292,49 @@ import {
 		version: 1,
 		apps: t
 	};
-}, Hn = async (e) => {
-	let t = await Ln(), n = (/* @__PURE__ */ new Date()).toISOString(), r = t.apps.findIndex((t) => t.id === e.id), i = e.inspectToken ?? process.env.VOLTRO_INSPECT_TOKEN, a = {
+}, Yn = async (e) => {
+	let t = await Wn(), 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 Rn({
+	await Gn({
 		version: 1,
 		apps: r >= 0 ? t.apps.map((e, t) => t === r ? a : e) : [...t.apps, a]
 	});
-}, Un = async (e) => {
+}, Xn = async (e) => {
 	try {
-		let t = await Ln(), n = t.apps.filter((t) => t.id !== e);
+		let t = await Wn(), n = t.apps.filter((t) => t.id !== e);
 		if (n.length === t.apps.length) return;
-		await Rn({
+		await Gn({
 			version: 1,
 			apps: n
 		});
 	} catch {}
-}, Wn = (e, t, n) => `${e}:${t}:${n}`, Y = l(R(), ".voltro", "logs"), Gn = () => {
+}, Zn = (e, t, n) => `${e}:${t}:${n}`, X = f(ie(), ".voltro", "logs"), Qn = () => {
 	let e = Number(process.env.VOLTRO_LOG_FILE_TTL_MS);
 	return Number.isFinite(e) && e > 0 ? e : 3600 * 1e3;
-}, Kn = !1, qn = () => {
-	if (Kn) return;
-	Kn = !0;
-	let e = Date.now() - Gn(), t = [];
+}, $n = !1, er = () => {
+	if ($n) return;
+	$n = !0;
+	let e = Date.now() - Qn(), t = [];
 	try {
-		t = A(Y);
+		t = N(X);
 	} catch {
 		return;
 	}
 	for (let n of t) {
 		if (!n.endsWith(".log")) continue;
-		let t = l(Y, n);
+		let t = f(X, n);
 		try {
-			j(t).mtimeMs < e && M(t);
+			P(t).mtimeMs < e && ee(t);
 		} catch {}
 	}
-}, Jn = (e) => e.replace(/[^a-zA-Z0-9._-]/g, "_").slice(0, 80), Yn = (e, t) => l(Y, `${Jn(e)}-${t}.log`), Xn = (e) => {
-	let t = Jn(e), n = [];
+}, tr = (e) => e.replace(/[^a-zA-Z0-9._-]/g, "_").slice(0, 80), nr = (e, t) => f(X, `${tr(e)}-${t}.log`), rr = (e) => {
+	let t = tr(e), n = [];
 	try {
-		n = A(Y);
+		n = N(X);
 	} catch {
 		return;
 	}
@@ -1335,19 +1342,19 @@ import {
 	if (r.length === 0) return;
 	let i, a = -1;
 	for (let e of r) {
-		let t = l(Y, e);
+		let t = f(X, e);
 		try {
-			let e = j(t);
+			let e = P(t);
 			e.mtimeMs > a && (a = e.mtimeMs, i = t);
 		} catch {}
 	}
 	return i;
-}, Zn = (e) => {
+}, ir = (e) => {
 	try {
-		E(Y, { recursive: !0 });
+		k(X, { recursive: !0 });
 	} catch {}
-	qn();
-	let t = Yn(e, process.pid), n = D(t, "w"), r = (e) => {
+	er();
+	let t = nr(e, process.pid), n = A(t, "w"), r = (e) => {
 		let t = {
 			ts: e.ts.getTime(),
 			level: e.level,
@@ -1368,15 +1375,15 @@ import {
 				...e.scope === void 0 ? {} : { scope: e.scope }
 			}) + "\n";
 		}
-	}, i = !1, a = x((e) => {
+	}, i = !1, a = w((e) => {
 		if (!i) try {
-			ee(n, r(e));
+			I(n, r(e));
 		} catch {}
 	}), o = () => {
 		if (!i) {
 			i = !0;
 			try {
-				w(n);
+				D(n);
 			} catch {}
 		}
 	};
@@ -1388,10 +1395,10 @@ import {
 			a(), o(), process.off("exit", o), process.off("uncaughtException", s), process.off("unhandledRejection", s);
 		}
 	};
-}, Qn = async (e, t) => {
+}, ar = async (e, t) => {
 	let n;
 	try {
-		n = await O.readFile(e, "utf8");
+		n = await j.readFile(e, "utf8");
 	} catch {
 		return [];
 	}
@@ -1402,78 +1409,78 @@ import {
 		i.push(t);
 	} catch {}
 	return t?.max !== void 0 && i.length > t.max ? i.slice(i.length - t.max) : i;
-}, $n = S({ scope: "voltro:dashboard" }), er = L(import.meta.url), tr = 5179, nr = (e) => {
+}, or = T({ scope: "voltro:dashboard" }), sr = re(import.meta.url), cr = 5179, lr = (e) => {
 	let t = process.env.VOLTRO_DASHBOARD_PATH;
-	if (t && T(l(d(t), "app.config.ts"))) return d(t);
+	if (t && O(f(m(t), "app.config.ts"))) return m(t);
 	try {
-		let e = s(er.resolve("@voltro/dashboard/package.json"));
-		if (T(l(e, "app.config.ts"))) return e;
+		let e = u(sr.resolve("@voltro/dashboard/package.json"));
+		if (O(f(e, "app.config.ts"))) return e;
 	} catch {}
-	let n = l("voltro-devtools", "apps", "dashboard"), r = d(e);
+	let n = f("voltro-devtools", "apps", "dashboard"), r = m(e);
 	for (let e = 0; e < 10; e++) {
-		let e = l(r, n);
-		if (T(l(e, "app.config.ts"))) return e;
-		let t = s(r);
+		let e = f(r, n);
+		if (O(f(e, "app.config.ts"))) return e;
+		let t = u(r);
 		if (t === r) break;
 		r = t;
 	}
 	return null;
-}, rr = "VOLTRO_IS_DASHBOARD", ir = (e, t = "127.0.0.1", n = 250) => new Promise((r) => {
-	let i = he({
+}, ur = "VOLTRO_IS_DASHBOARD", dr = (e, t = "127.0.0.1", n = 250) => new Promise((r) => {
+	let i = _e({
 		port: e,
 		host: t
 	}), a = !1, o = (e) => {
 		a || (a = !0, i.destroy(), r(e));
 	};
 	i.once("connect", () => o(!0)), i.once("error", () => o(!1)), setTimeout(() => o(!1), n);
-}), ar = () => !!(process.env.VOLTRO_DASHBOARD === "off" || process.argv.includes("--disable-dashboard")), or = () => process.env[rr] === "1", sr = () => process.stdout.isTTY === !0, X = l(R(), ".voltro", "dashboard-launch.lock"), cr = 1e4, lr = async () => {
+}), fr = () => !!(process.env.VOLTRO_DASHBOARD === "off" || process.argv.includes("--disable-dashboard")), pr = () => process.env[ur] === "1", mr = () => process.stdout.isTTY === !0, hr = f(ie(), ".voltro", "dashboard-launch.lock"), gr = 1e4, _r = async () => {
 	try {
-		await O.mkdir(s(X), { recursive: !0 });
-		let e = await O.open(X, "wx");
+		await j.mkdir(u(hr), { recursive: !0 });
+		let e = await j.open(hr, "wx");
 		return await e.write(`${process.pid}\n${Date.now()}\n`), await e.close(), !0;
 	} catch {
 		try {
-			let e = await O.stat(X);
-			if (Date.now() - e.mtimeMs > cr) return await O.unlink(X).catch(() => void 0), lr();
+			let e = await j.stat(hr);
+			if (Date.now() - e.mtimeMs > gr) return await j.unlink(hr).catch(() => void 0), _r();
 		} catch {}
 		return !1;
 	}
-}, ur = async () => {
+}, vr = async () => {
 	try {
-		await O.unlink(X);
+		await j.unlink(hr);
 	} catch {}
-}, dr = async (e) => {
+}, yr = async (e) => {
 	let t = e.port ?? 5179;
-	if (ar()) return {
+	if (fr()) return {
 		status: "skipped",
 		reason: "disabled by flag/env",
 		port: t
 	};
-	if (or()) return {
+	if (pr()) return {
 		status: "skipped",
 		reason: "this process IS the dashboard",
 		port: t
 	};
-	if (!sr()) return {
+	if (!mr()) return {
 		status: "skipped",
 		reason: "stdout is not a TTY (CI/smoke)",
 		port: t
 	};
-	if (!await lr()) return {
+	if (!await _r()) return {
 		status: "skipped",
 		reason: "another voltro process is currently launching the dashboard",
 		port: t
 	};
-	if (await ir(t)) return await ur(), {
+	if (await dr(t)) return await vr(), {
 		status: "already-running",
 		port: t
 	};
 	let n = e.voltroBin;
 	if (!n) {
 		let e = process.argv[1];
-		n = e && e.endsWith("/src/bin.ts") ? l(s(e), "..", "bin", "voltro.mjs") : e ?? "voltro";
+		n = e && e.endsWith("/src/bin.ts") ? f(u(e), "..", "bin", "voltro.mjs") : e ?? "voltro";
 	}
-	let r = T(l(e.dashboardAppPath, ".framework", "dist", "index.html")), i = r ? "start" : "dev", a = me(process.execPath, [
+	let r = O(f(e.dashboardAppPath, ".framework", "dist", "index.html")), i = r ? "start" : "dev", a = ge(process.execPath, [
 		n,
 		i,
 		e.dashboardAppPath
@@ -1481,7 +1488,7 @@ import {
 		stdio: "ignore",
 		env: {
 			...process.env,
-			[rr]: "1",
+			[ur]: "1",
 			VOLTRO_DASHBOARD_PORT: String(t)
 		}
 	});
@@ -1489,22 +1496,22 @@ import {
 		if (a.exitCode === null && a.signalCode === null) try {
 			a.kill("SIGTERM");
 		} catch {}
-	}), $n.info(`auto-launching dashboard at http://localhost:${t}`, {
+	}), or.info(`auto-launching dashboard at http://localhost:${t}`, {
 		port: t,
 		mode: i,
 		prebuilt: r
-	}), r || $n.debug("no pre-built dashboard — running `voltro dev`. Build with `cd voltro-devtools && pnpm build` for a fast prod boot."), $n.debug("disable via --disable-dashboard or VOLTRO_DASHBOARD=off"), setTimeout(() => {
-		ur();
+	}), r || or.debug("no pre-built dashboard — running `voltro dev`. Build with `cd voltro-devtools && pnpm build` for a fast prod boot."), or.debug("disable via --disable-dashboard or VOLTRO_DASHBOARD=off"), setTimeout(() => {
+		vr();
 	}, 4e3).unref(), {
 		status: "launched",
 		port: t
 	};
-}, fr = class extends Error {
+}, br = class extends Error {
 	_voltroDeferral = !0;
 	constructor(e) {
 		super(e), this.name = "DeferralNotSupportedError";
 	}
-}, pr = (e) => typeof e == "object" && !!e && e._voltroDeferral === !0, mr = (e) => {
+}, xr = (e) => typeof e == "object" && !!e && e._voltroDeferral === !0, Sr = (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);
@@ -1519,7 +1526,7 @@ import {
 			...e.layoutShell ? { layoutShell: e.layoutShell } : {}
 		});
 	} catch (e) {
-		throw new fr(e instanceof Error ? e.message : String(e));
+		throw new br(e instanceof Error ? e.message : String(e));
 	}
 	return {
 		loaderData: n.renderData,
@@ -1535,8 +1542,8 @@ import {
 			...Object.keys(a).length > 0 ? { deferredSegmentIds: a } : {}
 		}
 	};
-}, hr = (e) => {
-	let { helpers: t, renderInput: n } = e, r = mr({
+}, Cr = (e) => {
+	let { helpers: t, renderInput: n } = e, r = Sr({
 		helpers: t,
 		page: e.page,
 		pathname: n.pathname,
@@ -1557,42 +1564,42 @@ import {
 		stateScript: t.renderRouterStateScript(r.stateInput),
 		hasDeferred: r.hasDeferred
 	};
-}, gr = (e) => {
+}, wr = (e) => {
 	let { html: t, meta: n } = e.helpers.renderPageToHtml(e.prepared.renderInput);
 	return {
 		body: t,
 		meta: n
 	};
-}, _r = (e) => [
+}, Tr = (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    "), vr = "<div id=\"root\"></div>", yr = "<div id=\"root\">", br = "</div>", xr = /<script\b[^>]*\btype=["']module["'][^>]*><\/script>[ \t]*\n?/gi, Sr = /\bsrc=["']([^"']+)["']/i, Cr = /<script(?![^>]*\basync\b)([^>]*\btype=["']module["'][^>]*)>/gi, wr = (e) => {
-	let t = e.keepScriptInHead ?? ((e) => e.startsWith("/@")), n = [], r = e.shell.replace(xr, (e) => {
-		let r = Sr.exec(e)?.[1];
+].filter((e) => e.length > 0).join("\n    "), Er = "<div id=\"root\"></div>", Dr = "<div id=\"root\">", Or = "</div>", kr = /<script\b[^>]*\btype=["']module["'][^>]*><\/script>[ \t]*\n?/gi, Ar = /\bsrc=["']([^"']+)["']/i, jr = /<script(?![^>]*\basync\b)([^>]*\btype=["']module["'][^>]*)>/gi, Mr = (e) => {
+	let t = e.keepScriptInHead ?? ((e) => e.startsWith("/@")), n = [], r = e.shell.replace(kr, (e) => {
+		let r = Ar.exec(e)?.[1];
 		return r === void 0 || t(r) ? e : (n.push(r), "");
 	});
-	e.inlineModuleScriptsAsync && (r = r.replace(Cr, "<script async$1>"));
-	let i = r.indexOf(vr);
-	if (i === -1) throw Error(`[voltro] the generated shell has no \`${vr}\` 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(jr, "<script async$1>"));
+	let i = r.indexOf(Er);
+	if (i === -1) throw Error(`[voltro] the generated shell has no \`${Er}\` 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)}${yr}`,
-		tail: `${br}${r.slice(i + 21)}`,
+		head: `${r.slice(0, i)}${Dr}`,
+		tail: `${Or}${r.slice(i + 21)}`,
 		bootstrapModules: n
 	};
-}, Tr = (e) => e.head.replace("</head>", `    ${e.headInjection}\n  </head>`).replace(/<html(\s+lang="[^"]*")?/i, `<html lang="${e.htmlLang}"`), Er = (e) => {
+}, Nr = (e) => e.head.replace("</head>", `    ${e.headInjection}\n  </head>`).replace(/<html(\s+lang="[^"]*")?/i, `<html lang="${e.htmlLang}"`), Pr = (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(Tr({
+		t.flushHeaders?.(), t.write(Nr({
 			head: n.head,
 			headInjection: i(a.meta),
 			htmlLang: r
 		}));
-		let c = new ge();
+		let c = new ve();
 		c.pipe(t, { end: !1 }), c.on("end", () => {
 			t.end(n.tail);
 		}), a.stream.pipe(c);
@@ -1617,23 +1624,23 @@ import {
 		return;
 	}
 	c();
-}, Z = S({ scope: "voltro:dev:web" }), Dr = S({ scope: "vite" }), Or = await (async () => {
+}, Z = T({ scope: "voltro:dev:web" }), Fr = T({ scope: "vite" }), Ir = await (async () => {
 	try {
-		let e = l(s(f(import.meta.url)), "..", "package.json"), t = await O.readFile(e, "utf8");
+		let e = f(u(h(import.meta.url)), "..", "package.json"), t = await j.readFile(e, "utf8");
 		return JSON.parse(t).version ?? "0.0.0";
 	} catch {
 		return "0.0.0";
 	}
-})(), kr = async () => {
+})(), Lr = async () => {
 	try {
-		let e = s(f(import.meta.url)), t = d(e, "..", "..", "devtools");
-		if (T(l(t, "package.json"))) return t;
-		let n = d(e, "..", "..", "..", "devtools");
-		return T(l(n, "package.json")) ? n : null;
+		let e = u(h(import.meta.url)), t = m(e, "..", "..", "devtools");
+		if (O(f(t, "package.json"))) return t;
+		let n = m(e, "..", "..", "..", "devtools");
+		return O(f(n, "package.json")) ? n : null;
 	} catch {
 		return null;
 	}
-}, Ar = (e, t) => e.disableDevtools || !t ? [] : [
+}, Rr = (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",
@@ -1643,82 +1650,87 @@ import {
 	"  await import('@voltro/devtools/styles.css')",
 	"  Devtools = (await import('@voltro/devtools')).VoltroDevtools",
 	"}"
-], jr = (e, t) => e.disableDevtools || !t ? [] : ["  ...(Devtools ? { Devtools } : {}),"], Mr = (e) => e.sentry ? ["import { initSentryBrowser } from '@voltro/plugin-sentry/web'"] : [], Nr = (e) => e.sentry ? [
+], zr = (e, t) => e.disableDevtools || !t ? [] : ["  ...(Devtools ? { Devtools } : {}),"], Br = (e) => e.sentry ? ["import { initSentryBrowser } from '@voltro/plugin-sentry/web'"] : [], Vr = (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)})`
-] : [], Pr = (e) => e.env ? ["import './env.public'"] : [], Fr = (e) => {
-	let t = [], n = d(e);
+] : [], Hr = (e) => e.env ? ["import './env.public'"] : [], Ur = (e) => {
+	let t = [], n = m(e);
 	for (;;) {
-		T(l(n, "pnpm-workspace.yaml")) && t.push(n);
-		let e = s(n);
+		O(f(n, "pnpm-workspace.yaml")) && t.push(n);
+		let e = u(n);
 		if (e === n) break;
 		n = e;
 	}
 	return t;
-}, Ir = /* @__PURE__ */ new Set([
-	"layout.tsx",
-	"error.tsx",
-	"loading.tsx",
-	"not-found.tsx"
-]), Lr = (e) => /\.(test|spec)\.tsx$/.test(e), Rr = (e) => {
+}, Wr = gn, Gr = (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]}`;
-}, zr = /export\s+(?:async\s+)?(?:const|function|let|var)\s+loader\b/, Br = (e) => e.startsWith("(") && e.endsWith(")"), Vr = (e) => e.filter((e) => !Br(e)), Hr = (e) => {
-	let t = e.replace(/\.tsx$/, "").split("/").filter(Boolean).filter((e) => !Br(e)), n = t.length > 0 && t[t.length - 1] === "index" ? t.slice(0, -1) : t;
-	return n.length === 0 ? "/" : "/" + n.join("/");
-}, Ur = (e) => `${e.replace(/\.tsx$/, "").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) => {
-	let t = [], n = [], r = async (e, i) => {
-		let a = [];
+}, Kr = /export\s+(?:async\s+)?(?:const|function|let|var)\s+loader\b/, qr = (e) => e.startsWith("(") && e.endsWith(")"), Jr = (e) => e.filter((e) => !qr(e)), Yr = (e) => {
+	let n = e.replace(t, "").split("/").filter(Boolean).filter((e) => !qr(e)), r = n.length > 0 && n[n.length - 1] === "index" ? n.slice(0, -1) : n;
+	return r.length === 0 ? "/" : "/" + r.join("/");
+}, Xr = (e) => `${e.replace(t, "").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 (n) => {
+	let r = [], i = [], a = async (n, o) => {
+		let s = [];
 		try {
-			a = await O.readdir(e, { withFileTypes: !0 });
+			s = await j.readdir(n, { withFileTypes: !0 });
 		} catch {
 			return;
 		}
-		let o = a.filter((e) => e.isDirectory()).map((e) => e.name).sort(), s = a.filter((e) => e.isFile() && e.name.endsWith(".tsx") && !Lr(e.name)).map((e) => e.name).sort(), c = new Set(s), u = i.join("/");
-		if (s.some((e) => Ir.has(e))) {
-			let t = c.has("layout.tsx"), r = !1;
+		let c = s.filter((e) => e.isDirectory()).map((e) => e.name).sort(), l = s.filter((e) => e.isFile() && e.name.endsWith(".tsx") && !Wr(e.name)).map((e) => e.name).sort(), u = new Set(l), d = o.join("/");
+		if (l.some((t) => e.has(t))) {
+			let t = u.has("layout.tsx"), r = !1;
 			if (t) try {
-				let t = await O.readFile(l(e, "layout.tsx"), "utf8");
-				r = zr.test(t);
+				let e = await j.readFile(f(n, "layout.tsx"), "utf8");
+				r = Kr.test(e);
 			} catch {}
-			n.push({
-				dir: u,
-				chain: i,
-				contributesToUrl: i.length === 0 || !Br(i[i.length - 1]),
+			i.push({
+				dir: d,
+				chain: o,
+				contributesToUrl: o.length === 0 || !qr(o[o.length - 1]),
 				hasLayout: t,
 				hasLayoutLoader: r,
-				hasError: c.has("error.tsx"),
-				hasPending: c.has("loading.tsx"),
-				hasNotFound: c.has("not-found.tsx")
+				hasError: u.has("error.tsx"),
+				hasPending: u.has("loading.tsx"),
+				hasNotFound: u.has("not-found.tsx"),
+				specialFiles: l.filter((t) => e.has(t))
 			});
 		}
-		for (let e of s) {
-			if (Ir.has(e)) continue;
-			let n = u ? `${u}/${e}` : e;
-			t.push({
+		for (let e of l) {
+			if (!t.test(e)) continue;
+			let n = d ? `${d}/${e}` : e;
+			r.push({
 				file: n,
-				pattern: Hr(n),
-				ident: Ur(n),
-				dirChain: i
+				pattern: Yr(n),
+				ident: Xr(n),
+				dirChain: o
 			});
 		}
-		for (let t of o) await r(l(e, t), [...i, t]);
+		for (let e of c) await a(f(n, e), [...o, e]);
 	};
-	return await r(e, []), t.sort((e, t) => e.file < t.file ? -1 : 1), {
-		pages: t,
-		dirs: n
+	await a(n, []), r.sort((e, t) => e.file < t.file ? -1 : 1);
+	let o = /* @__PURE__ */ new Set();
+	for (let e of r) for (let t = e.dirChain.length; t >= 0; t--) o.add(e.dirChain.slice(0, t).join("/"));
+	let s = [], c = [];
+	for (let { specialFiles: e, ...t } of i) o.has(t.dir) ? s.push(t) : c.push({
+		dir: t.dir,
+		files: e
+	});
+	return {
+		pages: r,
+		dirs: s,
+		orphanedSpecials: c
 	};
-}, Wr = (e, t) => {
+}, Zr = (e, t) => {
 	let n = [];
 	for (let r = 0; r <= t.length; r++) {
 		let i = t.slice(0, r).join("/"), a = e.find((e) => e.dir === i);
 		a && n.push(a);
 	}
 	return n;
-}, Gr = async (e) => {
+}, Qr = async (e) => {
 	let { entries: t, loadLayout: n, loadError: r, loadPending: i, ctx: a } = e, o = {};
 	return {
 		chain: await Promise.all(t.map(async (e, t) => {
@@ -1740,10 +1752,10 @@ import {
 		})),
 		segmentLoaderData: o
 	};
-}, Kr = (e) => {
-	let t = Vr(e);
+}, $r = (e) => {
+	let t = Jr(e);
 	return t.length === 0 ? "" : "/" + t.join("/");
-}, qr = [
+}, ei = [
 	"// Hot-reload bridge: keep SSR-injected <link rel=\"stylesheet\"> tags",
 	"// in sync with Vite's CSS HMR. Without this, edits to .css files",
 	"// only update the JS-injected <style> overlay; the underlying <link>",
@@ -1836,7 +1848,7 @@ import {
 	"    _vdtErrorStart('Build error')",
 	"  })",
 	"}"
-].join("\n"), Jr = (e) => {
+].join("\n"), ti = (e) => {
 	let t = [], n = 0, r = e.split("/").filter(Boolean), i = [];
 	for (let e of r) e.startsWith("[[...") && e.endsWith("]]") ? (i.push("(.*)"), t.push(e.slice(5, -2)), n += 2) : e.startsWith("[...") && e.endsWith("]") ? (i.push("(.+)"), t.push(e.slice(4, -1)), n += 3) : e.startsWith("[") && e.endsWith("]") ? (i.push("([^/]+)"), t.push(e.slice(1, -1)), n += 1) : i.push(e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"));
 	let a = i.join("/");
@@ -1845,8 +1857,8 @@ import {
 		paramNames: t,
 		priority: n
 	};
-}, Yr = (e) => e.map((e) => {
-	let { regex: t, paramNames: n, priority: r } = Jr(e.pattern);
+}, ni = (e) => e.map((e) => {
+	let { regex: t, paramNames: n, priority: r } = ti(e.pattern);
 	return {
 		pattern: e.pattern,
 		file: e.file,
@@ -1855,7 +1867,7 @@ import {
 		paramNames: n,
 		priority: r
 	};
-}).slice().sort((e, t) => e.priority - t.priority), Xr = (e, t) => {
+}).slice().sort((e, t) => e.priority - t.priority), ri = (e, t) => {
 	for (let n of t) {
 		let t = n.regex.exec(e);
 		if (!t) continue;
@@ -1867,30 +1879,30 @@ import {
 		};
 	}
 	return null;
-}, Zr = async (e, t) => {
+}, ii = async (e, t) => {
 	let n = e;
 	for (;;) {
-		let e = l(n, "node_modules", t);
+		let e = f(n, "node_modules", t);
 		try {
-			if ((await O.stat(e)).isDirectory()) {
-				let t = await O.realpath(e);
+			if ((await j.stat(e)).isDirectory()) {
+				let t = await j.realpath(e);
 				return t.includes("/node_modules/") ? null : t;
 			}
 		} catch {}
-		let r = s(n);
+		let r = u(n);
 		if (r === n) return null;
 		n = r;
 	}
-}, Qr = async (e) => {
+}, ai = async (e) => {
 	try {
-		let t = await import(p(l(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;
+		let t = await import(g(f(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 ? {
 			port: r,
 			wsPath: a
 		} : { port: r };
 	} catch {}
 	return { port: 4e3 };
-}, $r = (e, t) => ({
+}, oi = (e, t) => ({
 	name: e,
 	pkg: t.package,
 	browserWsUrl: t.url,
@@ -1898,7 +1910,7 @@ import {
 	...t.serverUrl ? { serverOrigin: t.serverUrl } : {},
 	...t.headers ? { headers: t.headers } : {},
 	...t.authHeaders ? { hasAuthHeaders: !0 } : {}
-}), ei = (e, t, n) => {
+}), si = (e, t, n) => {
 	let r = t.transport?.wsPath ?? n.wsPath;
 	return {
 		name: e,
@@ -1910,7 +1922,7 @@ import {
 		...t.headers ? { headers: t.headers } : {},
 		...t.authHeaders ? { hasAuthHeaders: !0 } : {}
 	};
-}, ti = (e) => {
+}, ci = (e) => {
 	let t = /* @__PURE__ */ new Map();
 	for (let n of e) {
 		if (n.proxyTarget === void 0) continue;
@@ -1918,43 +1930,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);
 	}
-}, ni = async (e, t) => {
+}, li = async (e, t) => {
 	let n = Object.entries(t.apis ?? {}), r = [];
 	for (let [t, i] of n) {
 		if (i.url) {
-			r.push($r(t, i));
+			r.push(oi(t, i));
 			continue;
 		}
-		let n = await Zr(e, i.package);
+		let n = await ii(e, i.package);
 		if (!n) throw Error(`[voltro dev] api ${JSON.stringify(t)} (package ${JSON.stringify(i.package)}) is not a workspace dep and has no \`url\` set in app.config.ts. External apis need an explicit \`url\` because the framework can't discover their dev port.`);
-		r.push(ei(t, i, await Qr(n)));
+		r.push(si(t, i, await ai(n)));
 	}
-	return ti(r), r;
-}, ri = (e) => {
+	return ci(r), r;
+}, ui = (e) => {
 	if (!(!/^wss?:\/\//.test(e) && !/^https?:\/\//.test(e))) try {
 		let t = new URL(e);
 		return t.protocol = t.protocol === "wss:" || t.protocol === "https:" ? "https:" : "http:", `${t.protocol}//${t.host}`;
 	} catch {
 		return;
 	}
-}, ii = (e) => `VOLTRO_API_ORIGIN_${e.toUpperCase().replace(/[^A-Z0-9]/g, "_")}`, ai = (e) => process.env[ii(e)] ?? process.env.VOLTRO_API_ORIGIN, oi = (e, t) => {
+}, di = (e) => `VOLTRO_API_ORIGIN_${e.toUpperCase().replace(/[^A-Z0-9]/g, "_")}`, fi = (e) => process.env[di(e)] ?? process.env.VOLTRO_API_ORIGIN, pi = (e, t) => {
 	if (!e) return;
-	let n = ai(e.name) ?? e.serverOrigin;
+	let n = fi(e.name) ?? e.serverOrigin;
 	if (n) {
-		let e = ri(n);
+		let e = ui(n);
 		if (e) return e;
 	}
 	if (t?.allowDevProxy && e.proxyTarget) {
-		let t = ri(e.proxyTarget);
+		let t = ui(e.proxyTarget);
 		if (t) return t;
 	}
-	if (!e.proxyTarget && /^wss?:\/\//.test(e.browserWsUrl)) return ri(e.browserWsUrl);
-}, si = (e, t, n) => {
+	if (!e.proxyTarget && /^wss?:\/\//.test(e.browserWsUrl)) return ui(e.browserWsUrl);
+}, mi = (e, t, n) => {
 	if (!e) {
 		if (n?.apiName === void 0) return;
 		let e = n.apiName;
 		return async () => {
-			throw Error(`[loader.query] api '${e}' has no server-side origin for SSR. In a split web/api deployment the web pod reaches the api by internal DNS, not the browser's relative wsPath — set ${ii(e)} (or VOLTRO_API_ORIGIN, or apis.${e}.serverUrl in app.config.ts) to the api's internal origin, e.g. http://api.<namespace>.svc.cluster.local. The browser transport is unaffected.`);
+			throw Error(`[loader.query] api '${e}' has no server-side origin for SSR. In a split web/api deployment the web pod reaches the api by internal DNS, not the browser's relative wsPath — set ${di(e)} (or VOLTRO_API_ORIGIN, or apis.${e}.serverUrl in app.config.ts) to the api's internal origin, e.g. http://api.<namespace>.svc.cluster.local. The browser transport is unaffected.`);
 		};
 	}
 	return async (r, i) => {
@@ -1976,7 +1988,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 ${ii(n.apiName)} / VOLTRO_API_ORIGIN` : "Set the api server origin"} to the api's SSR-reachable origin (internal cluster DNS in a split deployment).`, { cause: t });
+			throw Error(`[loader.query] ${r}: could not reach the api at ${e}/rpc (${i}). ${n?.apiName ? `Set ${di(n.apiName)} / VOLTRO_API_ORIGIN` : "Set the api server origin"} to the api's SSR-reachable origin (internal cluster DNS in a split deployment).`, { cause: t });
 		}
 		if (!o.ok) throw Error(`[loader.query] ${r}: HTTP ${o.status} ${await o.text()}`);
 		let s = await o.json();
@@ -1994,8 +2006,8 @@ import {
 		}
 		if (u) return l;
 	};
-}, ci = 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(l(e, "node_modules", "@voltro", "devtools", "package.json")) || await kr() !== null, s = t.theme === "system" ? [
+}, hi = async (e, t, n, r = {}) => {
+	let i = t.title ?? t.name ?? "app", a = t.theme === "dark" ? " class=\"dark\"" : t.theme === "light" ? " class=\"light\"" : "", o = O(f(e, "node_modules", "@voltro", "devtools", "package.json")) || await Lr() !== null, s = t.theme === "system" ? [
 		"    <script>",
 		"      (function () {",
 		"        var root = document.documentElement",
@@ -2033,34 +2045,35 @@ import {
 		"  </body>",
 		"</html>",
 		""
-	].join("\n"), u = l(e, "src", "pages"), { pages: d, dirs: f } = await $(u);
-	await jn(u, d);
-	let p = (e) => `${e.replace(/[^a-zA-Z0-9]/g, "_")}AppGroup`, m = (e) => `${e.replace(/[^a-zA-Z0-9]/g, "_")}AppDescriptors`, h = n.map((e) => `import { appGroup as ${p(e.name)}, appDescriptors as ${m(e.name)} } from '${e.pkg}/rpcGroup'`);
-	n.some((e) => e.hasAuthHeaders) && (h.push("import __voltroAppConfig from '../app.config'"), h.push("const __voltroAuthHeaders = (__voltroAppConfig as { readonly apis?: Record<string, { readonly authHeaders?: () => Record<string, string> | Promise<Record<string, string>> }> }).apis"));
-	let g = n.map((e) => {
-		let t = [`group: ${p(e.name)}`];
-		return t.push(`descriptors: ${m(e.name)}`), t.push(`wsUrl: ${JSON.stringify(e.browserWsUrl)}`), e.hasAuthHeaders ? t.push(`headers: __voltroAuthHeaders?.[${JSON.stringify(e.name)}]?.authHeaders`) : e.headers && t.push(`headers: ${JSON.stringify(e.headers)}`), `    ${JSON.stringify(e.name)}: { ${t.join(", ")} },`;
-	}), _, v, y;
-	if (d.length > 0) {
-		let e = d.map((e) => `  ${JSON.stringify(e.pattern)}: () => import('../src/pages/${e.file}'),`), n = [];
-		for (let e of f) {
+	].join("\n"), l = f(e, "src", "pages"), { pages: u, dirs: d, orphanedSpecials: p } = await $(l);
+	await Rn(l, u);
+	for (let e of p) 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.`);
+	let m = (e) => `${e.replace(/[^a-zA-Z0-9]/g, "_")}AppGroup`, h = (e) => `${e.replace(/[^a-zA-Z0-9]/g, "_")}AppDescriptors`, g = n.map((e) => `import { appGroup as ${m(e.name)}, appDescriptors as ${h(e.name)} } from '${e.pkg}/rpcGroup'`);
+	n.some((e) => e.hasAuthHeaders) && (g.push("import __voltroAppConfig from '../app.config'"), g.push("const __voltroAuthHeaders = (__voltroAppConfig as { readonly apis?: Record<string, { readonly authHeaders?: () => Record<string, string> | Promise<Record<string, string>> }> }).apis"));
+	let _ = n.map((e) => {
+		let t = [`group: ${m(e.name)}`];
+		return t.push(`descriptors: ${h(e.name)}`), t.push(`wsUrl: ${JSON.stringify(e.browserWsUrl)}`), e.hasAuthHeaders ? t.push(`headers: __voltroAuthHeaders?.[${JSON.stringify(e.name)}]?.authHeaders`) : e.headers && t.push(`headers: ${JSON.stringify(e.headers)}`), `    ${JSON.stringify(e.name)}: { ${t.join(", ")} },`;
+	}), v, y, b;
+	if (u.length > 0) {
+		let e = u.map((e) => `  ${JSON.stringify(e.pattern)}: () => import('../src/pages/${e.file}'),`), n = [];
+		for (let e of d) {
 			let t = e.dir === "" ? "../src/pages" : `../src/pages/${e.dir}`;
 			e.hasLayout && e.hasLayoutLoader ? n.push(`import * as ${Q(e.dir, "Layout")}Mod from '${t}/layout.tsx'`) : e.hasLayout && n.push(`import ${Q(e.dir, "Layout")}   from '${t}/layout.tsx'`), e.hasError && n.push(`import ${Q(e.dir, "Error")}    from '${t}/error.tsx'`), e.hasPending && n.push(`import ${Q(e.dir, "Pending")}  from '${t}/loading.tsx'`), e.hasNotFound && n.push(`import ${Q(e.dir, "NotFound")} from '${t}/not-found.tsx'`);
 		}
-		let r = d.map((e) => {
-			let t = Wr(f, e.dirChain).map((e) => {
+		let r = u.map((e) => {
+			let t = Zr(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"}),`;
-		}), i = f.filter((e) => e.hasNotFound).map((e) => {
-			let t = Kr(e.chain), n = Wr(f, e.chain).map((e) => {
+		}), i = d.filter((e) => e.hasNotFound).map((e) => {
+			let t = $r(e.chain), n = Zr(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      ],` : "";
 			return `    {\n      prefix: ${JSON.stringify(t)},\n      Component: refs.notFounds[${JSON.stringify(e.dir)}],${r}\n    },`;
-		}), a = [], s = [], c = [], l = [], u = [], p = [];
-		for (let e of f) {
+		}), a = [], s = [], c = [], l = [], f = [], p = [];
+		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`, o = JSON.stringify(e.dir);
 			e.hasLayout && e.hasLayoutLoader ? (s.push(`  ${o}: ${Q(e.dir, "Layout")}Mod.default,`), c.push(`  ${o}: ${Q(e.dir, "Layout")}Mod.loader,`), a.push({
 				relPath: t,
@@ -2074,7 +2087,7 @@ import {
 				relPath: n,
 				kind: "error",
 				slotKey: e.dir
-			})), e.hasPending && (u.push(`  ${o}: ${Q(e.dir, "Pending")},`), a.push({
+			})), e.hasPending && (f.push(`  ${o}: ${Q(e.dir, "Pending")},`), a.push({
 				relPath: r,
 				kind: "pending",
 				slotKey: e.dir
@@ -2084,12 +2097,12 @@ import {
 				slotKey: e.dir
 			}));
 		}
-		for (let e of d) a.push({
+		for (let e of u) a.push({
 			relPath: `../src/pages/${e.file}`,
 			kind: "page",
 			slotKey: e.pattern
 		});
-		let m = a.map((e) => `      ${JSON.stringify(e.relPath)},`), b = a.map((e, t) => {
+		let m = a.map((e) => `      ${JSON.stringify(e.relPath)},`), h = a.map((e, t) => {
 			let n = JSON.stringify(e.slotKey);
 			return e.kind === "page" ? `      if (newMods[${t}] && refs.pages[${n}] !== undefined) { refs.pages[${n}] = newMods[${t}]; changed = true }` : `      if (newMods[${t}]?.default) { refs.${e.kind === "layout" ? "layouts" : e.kind === "error" ? "errors" : e.kind === "pending" ? "pendings" : "notFounds"}[${n}] = newMods[${t}].default;${e.kind === "layout" ? ` refs.layoutLoaders[${n}] = newMods[${t}].loader;` : ""} changed = true }`;
 		}), x = t.locales ?? [], S = x.length > 0, C = t.defaultLocale ?? x[0] ?? "en";
@@ -2100,7 +2113,7 @@ import {
 			"import { useServerRequest } from '@voltro/web'",
 			...x.map((e) => `import i18nCatalog_${e} from '../src/locales/${e}'`)
 		] : [];
-		v = [
+		y = [
 			"// GENERATED BY `voltro dev` — do not edit; will be overwritten on next boot.",
 			"// Routes + per-page chain + not-found scopes assembled from src/pages/.",
 			"//",
@@ -2143,7 +2156,7 @@ import {
 			...l,
 			"  },",
 			"  pendings: {",
-			...u,
+			...f,
 			"  },",
 			"  notFounds: {",
 			...p,
@@ -2215,13 +2228,13 @@ import {
 			"    ],",
 			"    (newMods: Array<Record<string, unknown> | undefined>) => {",
 			"      let changed = false",
-			...b,
+			...h,
 			"      if (changed) bump()",
 			"    },",
 			"  )",
 			"}",
 			""
-		].join("\n"), _ = [
+		].join("\n"), v = [
 			"// GENERATED BY `voltro dev` — do not edit; will be overwritten on next boot.",
 			"// The app's root component. It exports `App` and NOTHING ELSE: react-refresh",
 			"// only accepts a module whose every export is a component, and a module it",
@@ -2287,20 +2300,20 @@ import {
 			] : ["  return <Router routes={routes} notFounds={notFounds} />"],
 			"}",
 			""
-		].join("\n"), y = [
+		].join("\n"), b = [
 			"// GENERATED BY `voltro dev` — do not edit; will be overwritten on next boot.",
 			"// Entry: imports the generated App component and calls mount() with the",
 			"// resolved apis map. Side-effect only — no local component definitions —",
 			"// so downstream invalidations (user page edits) terminate at app.tsx.",
 			"",
-			...Pr(t),
+			...Hr(t),
 			"import { mount } from '@voltro/web'",
-			...h,
+			...g,
 			"import { App } from './app'",
 			"import { preloadCurrentRoute } from './routeTable'",
-			...Mr(t),
-			...Ar(t, o),
-			...Nr(t),
+			...Br(t),
+			...Rr(t, o),
+			...Vr(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",
@@ -2315,50 +2328,56 @@ import {
 			"",
 			"mount(App, {",
 			"  apis: {",
-			...g,
+			..._,
 			"  },",
-			...jr(t, o),
+			...zr(t, o),
 			"})",
 			"",
-			qr
+			ei
 		].join("\n");
-	} else _ = "", v = "", y = [
+	} else v = "", y = "", b = [
 		"// GENERATED BY `voltro dev` — do not edit; will be overwritten on next boot.",
 		"// The user's root component lives at ../src/App.tsx; this file imports it",
 		"// and calls mount(). Side-effect only, no component definitions, so the",
 		"// user's component file remains the Fast Refresh boundary.",
 		"",
-		...Pr(t),
+		...Hr(t),
 		"import { mount } from '@voltro/web'",
-		...h,
+		...g,
 		"import App from '../src/App'",
-		...Mr(t),
-		...Ar(t, o),
-		...Nr(t),
+		...Br(t),
+		...Rr(t, o),
+		...Vr(t),
 		"",
 		"mount(App, {",
 		"  apis: {",
-		...g,
+		..._,
 		"  },",
-		...jr(t, o),
+		...zr(t, o),
 		"})",
 		"",
-		qr
+		ei
 	].join("\n");
-	let b = l(e, ".framework");
-	await O.mkdir(b, { recursive: !0 }), t.env ? await Ze(b, r) : await O.rm(l(b, "env.public.ts"), { force: !0 }), await O.writeFile(l(b, "index.html"), c, "utf8"), await O.writeFile(l(b, "main.tsx"), y, "utf8"), _ ? (await O.writeFile(l(b, "app.tsx"), _, "utf8"), await O.writeFile(l(b, "routeTable.ts"), v, "utf8")) : (await O.rm(l(b, "app.tsx"), { force: !0 }), await O.rm(l(b, "routeTable.ts"), { force: !0 }));
-	let x = l(e, ".gitignore"), S = "";
+	let x = f(e, ".framework");
+	await j.mkdir(x, { recursive: !0 }), t.env ? await Qe(x, r) : await j.rm(f(x, "env.public.ts"), { force: !0 }), await j.writeFile(f(x, "index.html"), c, "utf8"), await j.writeFile(f(x, "main.tsx"), b, "utf8"), v ? (await j.writeFile(f(x, "app.tsx"), v, "utf8"), await j.writeFile(f(x, "routeTable.ts"), y, "utf8")) : (await j.rm(f(x, "app.tsx"), { force: !0 }), await j.rm(f(x, "routeTable.ts"), { force: !0 }));
+	let S = f(e, ".gitignore"), C = "";
 	try {
-		S = await O.readFile(x, "utf8");
+		C = await j.readFile(S, "utf8");
 	} catch {}
-	let C = ["/.framework/"], w = S.split("\n").filter((e) => e.trim() !== "");
-	for (let e of C) w.includes(e) || w.push(e);
-	await O.writeFile(x, w.join("\n") + "\n", "utf8");
-}, li = async (e, t) => {
+	let w = ["/.framework/"], T = new Set(C.split("\n").map((e) => e.trim())), E = w.filter((e) => !T.has(e));
+	if (E.length > 0) {
+		let e = C === "" || C.endsWith("\n") ? "" : "\n";
+		try {
+			await j.appendFile(S, `${e}${E.join("\n")}\n`, "utf8");
+		} catch (e) {
+			Z.warn(`could not add ${E.join(", ")} to ${S} — add it by hand so the generated directory stays out of git. The build is unaffected.`, { reason: e?.message ?? String(e) });
+		}
+	}
+}, gi = async (e, t) => {
 	try {
-		let n = l(s(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 = [];
+		let n = f(u(e), "project.json");
+		if (!O(n)) return;
+		let r = await j.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", {
@@ -2367,49 +2386,49 @@ import {
 			projectJson: n
 		});
 	} catch {}
-}, ui = (e) => l(e, ".framework", "dist", "server", "appConfig.js"), di = async (e) => {
-	let t = ui(e), n = T(t) ? t : l(e, "app.config.ts");
+}, _i = (e) => f(e, ".framework", "dist", "server", "appConfig.js"), vi = async (e) => {
+	let t = _i(e), n = O(t) ? t : f(e, "app.config.ts");
 	try {
-		let e = (await import(p(n).href)).default;
+		let e = (await import(g(n).href)).default;
 		return typeof e == "object" && e && "type" in e && e.type === "web" ? e : null;
 	} catch {
 		return null;
 	}
-}, fi = async (s) => {
-	let c = await di(s);
-	if (!c) return {
+}, yi = async (e) => {
+	let t = await vi(e);
+	if (!t) return {
 		ran: !1,
 		exitCode: 0
 	};
-	un();
-	let f = Nt();
-	Ut(f), Z.info("booting voltro dev (web)", { app: c.name ?? "(unnamed)" });
-	let p = await ni(s, c);
-	for (let e of p) Z.info("api wired", {
+	pn();
+	let n = It();
+	Kt(n), Z.info("booting voltro dev (web)", { app: t.name ?? "(unnamed)" });
+	let u = await li(e, t);
+	for (let e of u) Z.info("api wired", {
 		name: e.name,
 		pkg: e.pkg,
 		...e.proxyTarget ? { proxyTo: e.proxyTarget } : { directWs: e.browserWsUrl }
 	});
-	Be(s).then((e) => {
+	Ve(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 });
 		}
 	}).catch(() => {});
-	let { resolved: m } = await Qe({
-		rawEnv: c.env,
+	let { resolved: d } = await $e({
+		rawEnv: t.env,
 		appType: "web",
-		root: s,
+		root: e,
 		log: Z,
 		generateTypes: !0
-	}), h = m.publicValues;
-	await ci(s, c, p, h), Z.debug("generated framework entry files", { files: [
+	}), h = d.publicValues;
+	await hi(e, t, u, h), Z.debug("generated framework entry files", { files: [
 		"index.html",
 		".framework/main.tsx",
-		...c.env ? [".framework/env.public.ts"] : []
+		...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) : c.port ?? 5173, _ = c.name ?? "unnamed", v = Wn("web", _, g), y = Zn(_);
-	await Hn({
+	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 = Zn("web", _, g), y = ir(_);
+	await Yn({
 		id: v,
 		name: _,
 		kind: "web",
@@ -2417,19 +2436,19 @@ import {
 		pid: process.pid,
 		status: "booting",
 		logFile: y.path
-	}).catch(() => {}), await li(s, g);
-	let { pages: b, dirs: x } = await $(l(s, "src", "pages")), S = x.map((e) => ({
+	}).catch(() => {}), await gi(e, g);
+	let { pages: b, dirs: x } = await $(f(e, "src", "pages")), S = x.map((e) => ({
 		dir: e.dir,
 		hasLayout: e.hasLayout,
 		hasError: e.hasError,
 		hasPending: e.hasPending,
 		hasNotFound: e.hasNotFound
-	})), w = await jt({
-		appRoot: s,
+	})), C = await Pt({
+		appRoot: e,
 		pages: b
 	});
-	w.wrote && Z.debug("routes codegen wrote", { path: u(s, w.path) });
-	let E = await Ge("vite", () => import("vite")), D = (await import("@vitejs/plugin-react")).default, k = (await import("@tailwindcss/vite")).default, A = l(s, ".framework"), j = l(s, "src"), M = /* @__PURE__ */ new Set([
+	C.wrote && Z.debug("routes codegen wrote", { path: p(e, C.path) });
+	let w = await Ke("vite", () => import("vite")), T = (await import("@vitejs/plugin-react")).default, D = (await import("@tailwindcss/vite")).default, k = f(e, ".framework"), A = f(e, "src"), M = /* @__PURE__ */ new Set([
 		".framework",
 		"node_modules",
 		"dist",
@@ -2439,211 +2458,211 @@ import {
 		".cache"
 	]), N = {
 		name: "framework:watch-app-sources",
-		async configureServer(e) {
+		async configureServer(t) {
 			try {
-				let t = (await O.readdir(s, { withFileTypes: !0 })).filter((e) => e.isDirectory() && !M.has(e.name));
-				for (let n of t) e.watcher.add(l(s, n.name));
-				t.length === 0 && e.watcher.add(j);
+				let n = (await j.readdir(e, { withFileTypes: !0 })).filter((e) => e.isDirectory() && !M.has(e.name));
+				for (let r of n) t.watcher.add(f(e, r.name));
+				n.length === 0 && t.watcher.add(A);
 			} catch {
-				e.watcher.add(j);
+				t.watcher.add(A);
 			}
 			try {
-				let t = await O.readFile(l(s, "package.json"), "utf8"), n = JSON.parse(t), r = Object.keys({
-					...n.dependencies,
-					...n.devDependencies
+				let n = await j.readFile(f(e, "package.json"), "utf8"), r = JSON.parse(n), i = Object.keys({
+					...r.dependencies,
+					...r.devDependencies
 				});
-				await Promise.all(r.map(async (t) => {
-					let n = await Zr(s, t);
-					if (!n) return;
-					let r = l(n, "src");
+				await Promise.all(i.map(async (n) => {
+					let r = await ii(e, n);
+					if (!r) return;
+					let i = f(r, "src");
 					try {
-						(await O.stat(r)).isDirectory() && e.watcher.add(r);
+						(await j.stat(i)).isDirectory() && t.watcher.add(i);
 					} catch {}
 				}));
 			} catch {}
 		}
-	}, P = l(s, "src", "pages"), ee = (e) => e.endsWith(".tsx") && (e === P || e.startsWith(P + "/")), F = (e) => e === P || e.startsWith(P + "/"), te = async (e) => {
+	}, P = f(e, "src", "pages"), ee = (e) => e.endsWith(".tsx") && (e === P || e.startsWith(P + "/")), F = (e) => e === P || e.startsWith(P + "/"), te = async (n) => {
 		try {
-			let t = Date.now();
-			await ci(s, c, p, h);
-			let { pages: n } = await $(P);
-			await jt({
-				appRoot: s,
-				pages: n
+			let r = Date.now();
+			await hi(e, t, u, h);
+			let { pages: i } = await $(P);
+			await Pt({
+				appRoot: e,
+				pages: i
 			}), Z.info("page tree regenerated", {
-				reason: e,
-				ms: Date.now() - t
+				reason: n,
+				ms: Date.now() - r
 			});
-		} catch (t) {
-			Z.error("page tree regen failed", { reason: e }, t);
+		} catch (e) {
+			Z.error("page tree regen failed", { reason: n }, e);
 		}
 	}, I = {
 		name: "framework:regenerate-on-page-tree-change",
-		configureServer(e) {
-			let t = null, n = [], r = (e) => {
-				n.push(e), t && clearTimeout(t), t = setTimeout(() => {
-					t = null;
-					let e = n.length === 1 ? n[0] : `${n.length} events (${n[0]}, …)`;
-					n.length = 0, te(e);
+		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, te(e);
 				}, 50);
 			};
-			e.watcher.on("add", (e) => {
-				ee(e) && r(`add ${u(s, e)}`);
-			}), e.watcher.on("unlink", (e) => {
-				ee(e) && r(`unlink ${u(s, e)}`);
-			}), e.watcher.on("addDir", (e) => {
-				F(e) && r(`addDir ${u(s, e)}`);
-			}), e.watcher.on("unlinkDir", (e) => {
-				F(e) && r(`unlinkDir ${u(s, e)}`);
+			t.watcher.on("add", (t) => {
+				ee(t) && i(`add ${p(e, t)}`);
+			}), t.watcher.on("unlink", (t) => {
+				ee(t) && i(`unlink ${p(e, t)}`);
+			}), t.watcher.on("addDir", (t) => {
+				F(t) && i(`addDir ${p(e, t)}`);
+			}), t.watcher.on("unlinkDir", (t) => {
+				F(t) && i(`unlinkDir ${p(e, t)}`);
 			});
 		}
-	}, L = l(s, "app.config.ts"), R = (e) => {
-		if (!se(e.env)) return "";
+	}, L = f(e, "app.config.ts"), R = (e) => {
+		if (!le(e.env)) return "";
 		let t = Object.entries(e.env.vars).map(([e, t]) => `${e}:${t.access}`).sort();
 		return `${String(e.env.publicPrefix)}|${t.join(",")}`;
 	}, ne = (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"), R(e) !== R(t) && n.push("env"), n;
-	}, re = c, ie = d(L), ae = {
+	}, re = t, ie = m(L), ae = {
 		name: "framework:watch-app-config",
-		async configureServer(e) {
-			e.watcher.add(L), Z.info("watching app.config.ts for changes", { path: u(s, L) });
-			let t = async () => {
+		async configureServer(t) {
+			t.watcher.add(L), Z.info("watching app.config.ts for changes", { path: p(e, L) });
+			let n = async () => {
 				try {
 					try {
-						let t = e.moduleGraph.getModuleById(L);
-						t && e.moduleGraph.invalidateModule(t);
+						let e = t.moduleGraph.getModuleById(L);
+						e && t.moduleGraph.invalidateModule(e);
 					} catch {}
-					let t = (await e.ssrLoadModule(L, { fixStacktrace: !0 })).default;
-					return typeof t == "object" && t && "type" in t && t.type === "web" ? t : (Z.warn("app.config.ts re-load returned wrong shape", { hasDefault: t !== void 0 }), null);
+					let e = (await t.ssrLoadModule(L, { 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);
 				} catch (e) {
 					return Z.warn("app.config.ts re-load failed — ignoring this change", {}, e), null;
 				}
-			}, n = null, r = () => {
-				n && clearTimeout(n), n = setTimeout(() => {
-					n = null, i();
+			}, r = null, i = () => {
+				r && clearTimeout(r), r = setTimeout(() => {
+					r = null, a();
 				}, 100);
-			}, i = async () => {
-				let n = await t();
-				if (!n) {
+			}, a = async () => {
+				let r = await n();
+				if (!r) {
 					Z.info("app.config.ts onConfigChange: load returned null — skipping");
 					return;
 				}
 				if (Z.info("app.config.ts onConfigChange: loaded", {
-					theme: n.theme,
-					port: n.port,
-					name: n.name
-				}), JSON.stringify(n) === JSON.stringify(re)) {
+					theme: r.theme,
+					port: r.port,
+					name: r.name
+				}), JSON.stringify(r) === JSON.stringify(re)) {
 					Z.info("app.config.ts onConfigChange: parsed config unchanged — skipping (no-op edit?)");
 					return;
 				}
-				let r = ne(re, n);
-				if (r.length > 0) {
-					Z.warn("app.config.ts changed — hard restart required", { fields: r });
+				let i = ne(re, r);
+				if (i.length > 0) {
+					Z.warn("app.config.ts changed — hard restart required", { fields: i });
 					try {
-						await e.close();
+						await t.close();
 					} catch {}
-					let t = me(process.execPath, [...process.execArgv, ...process.argv.slice(1)], {
+					let e = ge(process.execPath, [...process.execArgv, ...process.argv.slice(1)], {
 						stdio: "inherit",
 						env: process.env,
 						cwd: process.cwd()
-					}), n = (e) => {
-						t.kill(e);
-					}, i = () => n("SIGINT"), a = () => n("SIGTERM");
-					process.on("SIGINT", i), process.on("SIGTERM", a), t.on("exit", (e, t) => {
-						process.off("SIGINT", i), process.off("SIGTERM", a), t ? process.kill(process.pid, t) : process.exit(e ?? 0);
-					}), t.on("error", (e) => {
+					}), n = (t) => {
+						e.kill(t);
+					}, r = () => n("SIGINT"), a = () => n("SIGTERM");
+					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);
 					});
 					return;
 				}
 				try {
-					let t = Date.now();
-					await ci(s, n, await ni(s, n)), re = n, e.ws && e.ws.send({
+					let n = Date.now();
+					await hi(e, r, await li(e, r)), re = r, t.ws && t.ws.send({
 						type: "full-reload",
 						path: "*"
 					}), Z.info("app.config.ts soft-regen", {
-						ms: Date.now() - t,
+						ms: Date.now() - n,
 						reload: "full"
 					});
 				} catch (e) {
 					Z.error("app.config.ts soft-regen failed", {}, e);
 				}
-			}, a = (e) => o(e) === "app.config.ts" ? e === L || d(e) === ie : !1;
-			e.watcher.on("change", (e) => {
-				a(e) && (Z.info("app.config.ts change event (chokidar)", { file: e }), r());
-			}), e.watcher.on("add", (e) => {
-				a(e) && (Z.info("app.config.ts add event (chokidar)", { file: e }), r());
+			}, o = (e) => l(e) === "app.config.ts" ? e === L || m(e) === ie : !1;
+			t.watcher.on("change", (e) => {
+				o(e) && (Z.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());
 			});
 			try {
 				let { watchFile: e } = await import("node:fs");
 				e(L, { interval: 500 }, (e, t) => {
-					e.mtimeMs !== t.mtimeMs && (Z.info("app.config.ts change event (poll)", { mtime: e.mtimeMs }), r());
+					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 });
 			} catch (e) {
 				Z.warn("app.config.ts polling watcher could not attach", {}, e);
 			}
-			ut(st, Z, {
-				root: s,
-				onBeforeRestart: () => e.close()
+			ft(lt, Z, {
+				root: e,
+				onBeforeRestart: () => t.close()
 			});
 		}
-	}, oe = /\/apps\/[^/]+\/.*\.(route|mutation|workflow|schema)\.tsx?$/, ce = {
+	}, oe = /\/apps\/[^/]+\/.*\.(route|mutation|workflow|schema)\.tsx?$/, se = {
 		name: "framework:suppress-api-hmr",
 		handleHotUpdate(e) {
 			if (oe.test(e.file)) return [];
 		}
-	}, le = {
+	}, ce = {
 		name: "framework:reoptimize-on-rpcgroup-change",
-		async configureServer(e) {
-			let t = /* @__PURE__ */ new Map();
-			for (let n of p) {
-				if (!n.proxyTarget) continue;
-				let r = await Zr(s, n.pkg);
-				if (!r) continue;
-				let i = l(r, "rpcGroup.generated.ts");
+		async configureServer(t) {
+			let n = /* @__PURE__ */ new Map();
+			for (let r of u) {
+				if (!r.proxyTarget) continue;
+				let i = await ii(e, r.pkg);
+				if (!i) continue;
+				let a = f(i, "rpcGroup.generated.ts");
 				try {
-					t.set(i, await O.readFile(i, "utf8"));
+					n.set(a, await j.readFile(a, "utf8"));
 				} catch {
-					t.set(i, "");
+					n.set(a, "");
 				}
 				try {
-					e.watcher.add(i);
+					t.watcher.add(a);
 				} catch {}
 			}
-			if (t.size === 0) return;
-			let n = null, r = !1, i = async () => {
-				if (r) return;
-				let n = null;
-				for (let [e, r] of t) {
+			if (n.size === 0) return;
+			let r = null, i = !1, a = async () => {
+				if (i) return;
+				let r = null;
+				for (let [e, t] of n) {
 					let i;
 					try {
-						i = await O.readFile(e, "utf8");
+						i = await j.readFile(e, "utf8");
 					} catch {
 						continue;
 					}
-					i !== r && (t.set(e, i), n = e);
+					i !== t && (n.set(e, i), r = e);
 				}
-				if (n !== null) {
-					r = !0, Z.info(`rpcGroup changed (${u(s, n)}) — re-bundling the api client + reloading (descriptor edits propagate automatically; no manual restart needed)`);
+				if (r !== null) {
+					i = !0, Z.info(`rpcGroup changed (${p(e, r)}) — re-bundling the api client + reloading (descriptor edits propagate automatically; no manual restart needed)`);
 					try {
-						await O.rm(l(A, ".vite", "deps"), {
+						await j.rm(f(k, ".vite", "deps"), {
 							recursive: !0,
 							force: !0
-						}), await e.restart(!0);
+						}), await t.restart(!0);
 					} catch (e) {
-						r = !1, Z.error("rpcGroup re-optimize failed", {}, e);
+						i = !1, Z.error("rpcGroup re-optimize failed", {}, e);
 					}
 				}
-			}, a = (e) => {
-				t.has(d(e)) && (n && clearTimeout(n), n = setTimeout(() => {
-					i();
+			}, o = (e) => {
+				n.has(m(e)) && (r && clearTimeout(r), r = setTimeout(() => {
+					a();
 				}, 120));
 			};
-			e.watcher.on("change", a), e.watcher.on("add", a);
+			t.watcher.on("change", o), t.watcher.on("add", o);
 		}
 	}, z = {};
-	for (let e of p) {
+	for (let e of u) {
 		if (!e.proxyTarget) continue;
 		z[e.browserWsUrl] = {
 			target: e.proxyTarget,
@@ -2658,225 +2677,225 @@ import {
 			rewrite: (t) => t.replace(RegExp(`^/_voltro/api/${e.name}`), "")
 		};
 	}
-	for (let [e, t] of Object.entries(c.proxies ?? {})) {
+	for (let [e, n] of Object.entries(t.proxies ?? {})) {
 		if (z[e]) {
 			Z.warn("user proxy ignored — prefix already claimed by an api ws proxy", { prefix: e });
 			continue;
 		}
 		z[e] = {
-			target: t.target,
-			changeOrigin: t.changeOrigin ?? !0,
-			...t.rewrite === void 0 ? {} : { rewrite: (n) => n.replace(RegExp(`^${e}`), t.rewrite) }
-		}, Z.info(`proxy ${e} → ${t.target}`, {
+			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}`, {
 			prefix: e,
-			target: t.target,
-			...t.rewrite === void 0 ? {} : { rewrite: t.rewrite }
+			target: n.target,
+			...n.rewrite === void 0 ? {} : { rewrite: n.rewrite }
 		});
 	}
 	let ue = {
 		name: "framework:inspect",
-		configureServer(o) {
+		configureServer(l) {
 			let u = null, d = async () => {
 				if (u !== null) return u;
-				let e = [];
-				for (let t of b) try {
-					let n = await o.ssrLoadModule(l(s, "src", "pages", t.file));
-					e.push({
-						pattern: t.pattern,
-						file: t.file,
-						dirChain: t.dirChain,
-						renderMode: Dn(n, l("src", "pages", t.file)),
-						interactive: n.interactive ?? "full",
-						tenantAware: n.tenantAware === !0,
-						revalidateMs: K(n.revalidate),
-						staleWhileRevalidateMs: K(n.staleWhileRevalidate) ?? 0,
-						cacheInvalidatesOn: Array.isArray(n.cacheInvalidatesOn) ? n.cacheInvalidatesOn : [],
-						hasLoader: typeof n.loader == "function",
-						hasMeta: n.meta != null,
-						hasGetStaticPaths: typeof n.getStaticPaths == "function"
+				let t = [];
+				for (let n of b) try {
+					let r = await l.ssrLoadModule(f(e, "src", "pages", n.file));
+					t.push({
+						pattern: n.pattern,
+						file: n.file,
+						dirChain: n.dirChain,
+						renderMode: Nn(r, f("src", "pages", n.file)),
+						interactive: r.interactive ?? "full",
+						tenantAware: r.tenantAware === !0,
+						revalidateMs: J(r.revalidate),
+						staleWhileRevalidateMs: J(r.staleWhileRevalidate) ?? 0,
+						cacheInvalidatesOn: Array.isArray(r.cacheInvalidatesOn) ? r.cacheInvalidatesOn : [],
+						hasLoader: typeof r.loader == "function",
+						hasMeta: r.meta != null,
+						hasGetStaticPaths: typeof r.getStaticPaths == "function"
 					});
 				} catch (e) {
-					Z.warn("inspect: failed to load page metadata", { pattern: t.pattern }, e);
+					Z.warn("inspect: failed to load page metadata", { pattern: n.pattern }, e);
 				}
-				return u = e, e;
+				return u = t, t;
 			};
-			o.middlewares.use((e, t, n) => {
-				let r = e.url ?? "/";
-				if (r.startsWith("/_voltro/inspect") || r.startsWith("/api/dashboard/proxy")) return n();
-				let i = Date.now(), a = t.end.bind(t);
+			l.middlewares.use((e, t, r) => {
+				let i = e.url ?? "/";
+				if (i.startsWith("/_voltro/inspect") || i.startsWith("/api/dashboard/proxy")) return r();
+				let a = Date.now(), o = t.end.bind(t);
 				t.end = ((...e) => {
 					try {
-						f.emit("request", {
-							url: r.split("?")[0],
+						n.emit("request", {
+							url: i.split("?")[0],
 							status: t.statusCode ?? 0,
-							durationMs: Date.now() - i
+							durationMs: Date.now() - a
 						});
 					} catch {}
-					return a(...e);
-				}), n();
-			}), c.name === "voltroDashboard" && o.middlewares.use(async (t, r, i) => {
-				let a = t.url ?? "", o = a.split("?")[0];
+					return o(...e);
+				}), r();
+			}), t.name === "voltroDashboard" && l.middlewares.use(async (e, t, n) => {
+				let i = e.url ?? "", o = i.split("?")[0];
 				if (o === "/api/dashboard/proxy") {
-					let i = new URL(a, "http://x").searchParams.get("target");
-					if (!i) {
-						r.statusCode = 400, r.end("missing ?target=");
+					let n = new URL(i, "http://x").searchParams.get("target");
+					if (!n) {
+						t.statusCode = 400, t.end("missing ?target=");
 						return;
 					}
-					if (!n(i)) {
-						r.statusCode = 400, r.end("target not allowed: must be loopback or an origin configured in VOLTRO_DASHBOARD_APPS");
+					if (!a(n)) {
+						t.statusCode = 400, t.end("target not allowed: must be loopback or an origin configured in VOLTRO_DASHBOARD_APPS");
 						return;
 					}
 					try {
-						let n = { accept: String(t.headers.accept ?? "application/json") };
-						t.headers.authorization ? n.authorization = String(t.headers.authorization) : e(i) && process.env.VOLTRO_INSPECT_TOKEN && (n.authorization = `Bearer ${process.env.VOLTRO_INSPECT_TOKEN}`);
+						let i = { accept: String(e.headers.accept ?? "application/json") };
+						e.headers.authorization ? i.authorization = String(e.headers.authorization) : r(n) && process.env.VOLTRO_INSPECT_TOKEN && (i.authorization = `Bearer ${process.env.VOLTRO_INSPECT_TOKEN}`);
 						let a;
-						if (t.method && t.method !== "GET" && t.method !== "HEAD") {
-							let e = [];
-							for await (let n of t) e.push(n);
-							a = Buffer.concat(e);
-							let r = t.headers["content-type"];
-							r && (n["content-type"] = Array.isArray(r) ? r[0] : String(r));
+						if (e.method && e.method !== "GET" && e.method !== "HEAD") {
+							let t = [];
+							for await (let n of e) t.push(n);
+							a = Buffer.concat(t);
+							let n = e.headers["content-type"];
+							n && (i["content-type"] = Array.isArray(n) ? n[0] : String(n));
 						}
-						let o = await fetch(i, {
+						let o = await fetch(n, {
 							redirect: "manual",
-							...t.method ? { method: t.method } : {},
-							headers: n,
+							...e.method ? { method: e.method } : {},
+							headers: i,
 							...a && a.length ? { body: new Uint8Array(a.buffer, a.byteOffset, a.byteLength) } : {}
 						}), s = Buffer.from(await o.arrayBuffer());
-						r.statusCode = o.status, r.setHeader("content-type", o.headers.get("content-type") ?? "application/octet-stream"), r.setHeader("content-length", String(s.length)), r.end(s);
+						t.statusCode = o.status, t.setHeader("content-type", o.headers.get("content-type") ?? "application/octet-stream"), t.setHeader("content-length", String(s.length)), t.end(s);
 					} catch (e) {
-						r.statusCode = 502, r.end(`proxy error: ${e.message}`);
+						t.statusCode = 502, t.end(`proxy error: ${e.message}`);
 					}
 					return;
 				}
 				if (o === "/api/dashboard/proxy/stream") {
-					let i = new URL(a, "http://x").searchParams.get("target");
-					if (!i) {
-						r.statusCode = 400, r.end("missing ?target=");
+					let n = new URL(i, "http://x").searchParams.get("target");
+					if (!n) {
+						t.statusCode = 400, t.end("missing ?target=");
 						return;
 					}
-					if (!n(i)) {
-						r.statusCode = 400, r.end("target not allowed: must be loopback or an origin configured in VOLTRO_DASHBOARD_APPS");
+					if (!a(n)) {
+						t.statusCode = 400, t.end("target not allowed: must be loopback or an origin configured in VOLTRO_DASHBOARD_APPS");
 						return;
 					}
 					let o = new AbortController();
-					t.on("close", () => o.abort()), r.on("close", () => o.abort());
+					e.on("close", () => o.abort()), t.on("close", () => o.abort());
 					try {
-						let n = await fetch(i, {
+						let i = await fetch(n, {
 							redirect: "manual",
 							method: "GET",
 							headers: {
 								accept: "text/event-stream",
-								...t.headers.authorization ? { authorization: String(t.headers.authorization) } : e(i) && process.env.VOLTRO_INSPECT_TOKEN ? { authorization: `Bearer ${process.env.VOLTRO_INSPECT_TOKEN}` } : {}
+								...e.headers.authorization ? { authorization: String(e.headers.authorization) } : r(n) && process.env.VOLTRO_INSPECT_TOKEN ? { authorization: `Bearer ${process.env.VOLTRO_INSPECT_TOKEN}` } : {}
 							},
 							signal: o.signal
 						});
-						if (!n.ok || !n.body) {
-							r.statusCode = n.status, r.end(`upstream ${n.status}`);
+						if (!i.ok || !i.body) {
+							t.statusCode = i.status, t.end(`upstream ${i.status}`);
 							return;
 						}
-						r.writeHead(200, {
+						t.writeHead(200, {
 							"content-type": "text/event-stream; charset=utf-8",
 							"cache-control": "no-cache, no-transform",
 							connection: "keep-alive",
 							"x-accel-buffering": "no"
 						});
-						let a = n.body.getReader();
+						let a = i.body.getReader();
 						try {
 							for (;;) {
-								let { done: e, value: t } = await a.read();
+								let { done: e, value: n } = await a.read();
 								if (e) break;
-								t && r.write(Buffer.from(t));
+								n && t.write(Buffer.from(n));
 							}
 						} finally {
-							a.releaseLock(), r.end();
+							a.releaseLock(), t.end();
 						}
 					} catch (e) {
-						e.name !== "AbortError" && (r.statusCode = 502, r.end(`proxy stream error: ${e.message}`));
+						e.name !== "AbortError" && (t.statusCode = 502, t.end(`proxy stream error: ${e.message}`));
 					}
 					return;
 				}
-				i();
-			}), o.middlewares.use(async (e, n, o) => {
-				let s = e.url ?? "";
-				if (!s.startsWith("/_voltro/inspect")) return o();
-				let l = {};
-				for (let [t, n] of Object.entries(e.headers ?? {})) n !== void 0 && (l[String(t).toLowerCase()] = Array.isArray(n) ? n.join(", ") : String(n));
-				let u = s.split("?")[0];
-				if (e.method === "GET" && (u === "/_voltro/inspect/logs" || s.startsWith("/_voltro/inspect/logs?"))) {
-					let e = a(l.origin), t = nn(s, Vt(), l);
-					n.statusCode = t.status, n.setHeader("content-type", t.contentType);
-					for (let [t, r] of Object.entries(e)) n.setHeader(t, r);
-					n.end(t.body);
+				n();
+			}), l.middlewares.use(async (e, r, a) => {
+				let l = e.url ?? "";
+				if (!l.startsWith("/_voltro/inspect")) return a();
+				let u = {};
+				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 = l.split("?")[0];
+				if (e.method === "GET" && (f === "/_voltro/inspect/logs" || l.startsWith("/_voltro/inspect/logs?"))) {
+					let e = c(u.origin), t = on(l, Wt(), 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);
 					return;
 				}
-				if (e.method === "POST" && u === "/_voltro/inspect/clientLog") {
-					let r = a(l.origin);
-					if (t()) {
-						n.statusCode = 503, n.setHeader("content-type", "application/json");
-						for (let [e, t] of Object.entries(r)) n.setHeader(e, t);
-						n.end(JSON.stringify({ error: "inspect disabled (VOLTRO_INSPECT=off)" }));
+				if (e.method === "POST" && f === "/_voltro/inspect/clientLog") {
+					let t = c(u.origin);
+					if (i()) {
+						r.statusCode = 503, r.setHeader("content-type", "application/json");
+						for (let [e, n] of Object.entries(t)) r.setHeader(e, n);
+						r.end(JSON.stringify({ error: "inspect disabled (VOLTRO_INSPECT=off)" }));
 						return;
 					}
-					let i = "";
+					let a = "";
 					e.setEncoding("utf-8"), e.on("data", (e) => {
-						i += e;
+						a += e;
 					}), e.on("end", () => {
-						let e = Xt(i, f);
-						n.statusCode = e.status, n.setHeader("content-type", e.contentType);
-						for (let [e, t] of Object.entries(r)) n.setHeader(e, t);
-						n.end(e.body);
+						let e = $t(a, 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);
 					}), e.on("error", () => {
-						n.statusCode = 400, n.setHeader("content-type", "application/json"), n.end(JSON.stringify({ error: "read failed" }));
+						r.statusCode = 400, r.setHeader("content-type", "application/json"), r.end(JSON.stringify({ error: "read failed" }));
 					});
 					return;
 				}
-				if (u === "/_voltro/inspect/stream") {
-					let i = a(l.origin);
-					if (t()) {
-						n.statusCode = 503, n.setHeader("content-type", "application/json");
-						for (let [e, t] of Object.entries(i)) n.setHeader(e, t);
-						n.end(JSON.stringify({ error: "inspect disabled (VOLTRO_INSPECT=off)" }));
+				if (f === "/_voltro/inspect/stream") {
+					let t = c(u.origin);
+					if (i()) {
+						r.statusCode = 503, r.setHeader("content-type", "application/json");
+						for (let [e, n] of Object.entries(t)) r.setHeader(e, n);
+						r.end(JSON.stringify({ error: "inspect disabled (VOLTRO_INSPECT=off)" }));
 						return;
 					}
-					let o = r(l);
-					if (!o.ok) {
-						n.statusCode = 401, n.setHeader("content-type", "application/json");
-						for (let [e, t] of Object.entries(i)) n.setHeader(e, t);
-						n.end(JSON.stringify({
+					let a = o(u);
+					if (!a.ok) {
+						r.statusCode = 401, r.setHeader("content-type", "application/json");
+						for (let [e, n] of Object.entries(t)) r.setHeader(e, n);
+						r.end(JSON.stringify({
 							error: "unauthorized",
-							reason: o.reason
+							reason: a.reason
 						}));
 						return;
 					}
-					n.statusCode = 200, n.setHeader("content-type", "text/event-stream; charset=utf-8"), n.setHeader("cache-control", "no-cache, no-transform"), n.setHeader("connection", "keep-alive"), n.setHeader("x-accel-buffering", "no");
-					for (let [e, t] of Object.entries(i)) n.setHeader(e, t);
-					n.flushHeaders?.(), n.write("retry: 5000\n\n");
-					let c = s.indexOf("?");
-					if (!(c !== -1 && new URLSearchParams(s.slice(c + 1)).get("live") === "1")) for (let e of f.buffered()) n.write(Pt(e));
-					let u = f.subscribe((e) => {
+					r.statusCode = 200, r.setHeader("content-type", "text/event-stream; charset=utf-8"), r.setHeader("cache-control", "no-cache, no-transform"), r.setHeader("connection", "keep-alive"), r.setHeader("x-accel-buffering", "no");
+					for (let [e, n] of Object.entries(t)) r.setHeader(e, n);
+					r.flushHeaders?.(), r.write("retry: 5000\n\n");
+					let s = l.indexOf("?");
+					if (!(s !== -1 && new URLSearchParams(l.slice(s + 1)).get("live") === "1")) for (let e of n.buffered()) r.write(Lt(e));
+					let d = n.subscribe((e) => {
 						try {
-							n.write(Pt(e));
+							r.write(Lt(e));
 						} catch {}
-					}), d = setInterval(() => {
+					}), f = setInterval(() => {
 						try {
-							n.write(Ft());
+							r.write(Rt());
 						} catch {}
 					}, 15e3), p = () => {
-						clearInterval(d), u();
+						clearInterval(f), d();
 					};
-					e.on("close", p), n.on("close", p);
+					e.on("close", p), r.on("close", p);
 					return;
 				}
 				try {
-					let t = i(s, {
+					let n = s(l, {
 						kind: "web",
 						meta: {
-							name: c.name ?? "(unnamed)",
-							voltroVersion: Or,
+							name: t.name ?? "(unnamed)",
+							voltroVersion: Ir,
 							port: g,
 							mode: "dev",
-							apis: Object.entries(c.apis ?? {}).map(([e, t]) => {
+							apis: Object.entries(t.apis ?? {}).map(([e, t]) => {
 								let n = {
 									name: e,
 									package: t.package
@@ -2891,58 +2910,58 @@ import {
 							size: 0,
 							entries: []
 						}),
-						env: () => et(c.name ?? "app", { contract: se(c.env) ? c.env : void 0 })
-					}, l, { method: e.method ?? "GET" });
-					if (t === null) return o();
-					n.statusCode = t.status, n.setHeader("content-type", t.contentType);
-					for (let [e, r] of Object.entries(t.headers ?? {})) n.setHeader(e, r);
-					n.end(t.body);
+						env: () => tt(t.name ?? "app", { contract: le(t.env) ? t.env : void 0 })
+					}, u, { method: e.method ?? "GET" });
+					if (n === null) return a();
+					r.statusCode = n.status, r.setHeader("content-type", n.contentType);
+					for (let [e, t] of Object.entries(n.headers ?? {})) r.setHeader(e, t);
+					r.end(n.body);
 				} catch (e) {
-					n.statusCode = 500, n.setHeader("content-type", "text/plain"), n.end(`inspect handler error: ${e.message}`);
+					r.statusCode = 500, r.setHeader("content-type", "text/plain"), r.end(`inspect handler error: ${e.message}`);
 				}
 			});
 		}
-	}, de = c.name === "voltroDashboard" ? {
+	}, de = t.name === "voltroDashboard" ? {
 		name: "framework:dashboard-registry",
 		configureServer(e) {
 			e.middlewares.use(async (e, t, n) => {
 				if (!(e.url ?? "").startsWith("/api/dashboard/registry")) return n();
 				try {
-					let e = await Vn();
+					let e = await Jn();
 					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, fe = Yr(b), B = /* @__PURE__ */ new Set(), he = yt(), ge = xt({
-		limit: he,
+	} : null, fe = ni(b), pe = /* @__PURE__ */ new Set(), B = St(), me = wt({
+		limit: B,
 		onColdStart: (e) => Z.debug("ssr cold-compile start", { id: e }),
 		onColdEnd: (e) => Z.debug("ssr cold-compile end", { id: e })
 	});
-	Z.debug(`ssr cold-compile concurrency ${he}`, { concurrency: he });
-	let _e = null, ve = async () => (_e === null && (_e = await O.readFile(l(s, ".framework", "index.html"), "utf8")), _e), ye = {
+	Z.debug(`ssr cold-compile concurrency ${B}`, { concurrency: B });
+	let V = null, _e = async () => (V === null && (V = await j.readFile(f(e, ".framework", "index.html"), "utf8")), V), ve = {
 		name: "framework:ssr",
-		configureServer(e) {
-			let t = (t) => ge.load(t, async () => await e.ssrLoadModule(t));
-			e.middlewares.use(async (n, r, i) => {
-				if (n.method !== "GET" && n.method !== "HEAD") return i();
-				let a = n.url ?? "/", o = a.indexOf("?"), c = (o === -1 ? a : a.slice(0, o)) || "/";
-				if (c.startsWith("/@") || c.startsWith("/node_modules/") || c.startsWith("/.framework/") || c.startsWith("/_voltro/") || c === "/main.tsx" || c === "/index.html" || c === "/sw.js" || c === "/favicon.ico" || c === "/robots.txt" || /\.[a-z0-9]+$/i.test(c)) return i();
-				let u = Xr(c, fe);
-				if (!u) return i();
-				let d = !B.has(u.route.pattern), f = Date.now();
-				d && Z.info(`ssr compiling ${u.route.pattern}`, {
-					pattern: u.route.pattern,
+		configureServer(t) {
+			let n = (e) => me.load(e, async () => await t.ssrLoadModule(e));
+			t.middlewares.use(async (r, i, a) => {
+				if (r.method !== "GET" && r.method !== "HEAD") return a();
+				let o = r.url ?? "/", s = o.indexOf("?"), c = (s === -1 ? o : o.slice(0, s)) || "/";
+				if (c.startsWith("/@") || c.startsWith("/node_modules/") || c.startsWith("/.framework/") || c.startsWith("/_voltro/") || c === "/main.tsx" || c === "/index.html" || c === "/sw.js" || c === "/favicon.ico" || c === "/robots.txt" || /\.[a-z0-9]+$/i.test(c)) return a();
+				let l = ri(c, fe);
+				if (!l) return a();
+				let d = !pe.has(l.route.pattern), p = Date.now();
+				d && Z.info(`ssr compiling ${l.route.pattern}`, {
+					pattern: l.route.pattern,
 					pathname: c
 				});
 				let m = {}, h = async (e, t) => {
 					let n = Date.now(), r = await t();
 					return m[e] = (m[e] ?? 0) + (Date.now() - n), r;
-				}, g = async (t, n, r) => {
-					let i = await e.moduleGraph.getModuleById(t);
-					if (!(!i || n.has(t))) {
-						if (n.add(t), i.id && /\.(css|sass|scss|less|stylus|pcss|postcss)(\?|$)/.test(i.id)) {
+				}, g = async (e, n, r) => {
+					let i = await t.moduleGraph.getModuleById(e);
+					if (!(!i || n.has(e))) {
+						if (n.add(e), i.id && /\.(css|sass|scss|less|stylus|pcss|postcss)(\?|$)/.test(i.id)) {
 							let e = i.url.replace(/\?.*$/, "");
 							r.includes(e) || r.push(e);
 							return;
@@ -2951,97 +2970,97 @@ import {
 					}
 				};
 				try {
-					let o = await h("loadPage", async () => await t(l(s, "src", "pages", u.route.file))), _ = Dn(o, l("src", "pages", u.route.file)), v = Wr(x, u.route.dirChain), y = _ === "spa" && v.some((e) => e.hasLayout);
-					if (_ !== "ssr" && _ !== "isr" && !y) return i();
+					let s = await h("loadPage", async () => await n(f(e, "src", "pages", l.route.file))), _ = Nn(s, f("src", "pages", l.route.file)), v = Zr(x, l.route.dirChain), y = _ === "spa" && v.some((e) => e.hasLayout);
+					if (_ !== "ssr" && _ !== "isr" && !y) return a();
 					let b = {};
-					for (let [e, t] of Object.entries(n.headers ?? {})) typeof t == "string" ? b[e] = t : Array.isArray(t) && (b[e] = t.join(", "));
-					let S = si(oi(p[0], { allowDevProxy: !0 }), b.cookie, { apiName: p[0]?.name }), C = new AbortController(), w = () => C.abort();
-					r.once("close", w);
+					for (let [e, t] of Object.entries(r.headers ?? {})) typeof t == "string" ? b[e] = t : Array.isArray(t) && (b[e] = t.join(", "));
+					let S = mi(pi(u[0], { allowDevProxy: !0 }), b.cookie, { apiName: u[0]?.name }), C = new AbortController(), w = () => C.abort();
+					i.once("close", w);
 					let T = null, E = [], D = {};
 					try {
-						({chain: E, segmentLoaderData: D} = await h("loadChain", () => Gr({
+						(await n("@voltro/web/ssr")).beginStoreSeeds(), {chain: E, segmentLoaderData: D} = await h("loadChain", () => Qr({
 							entries: v,
-							loadLayout: (e) => t(l(s, "src", "pages", e.dir, "layout.tsx")),
-							loadError: (e) => t(l(s, "src", "pages", e.dir, "error.tsx")),
-							loadPending: (e) => t(l(s, "src", "pages", e.dir, "loading.tsx")),
+							loadLayout: (t) => n(f(e, "src", "pages", t.dir, "layout.tsx")),
+							loadError: (t) => n(f(e, "src", "pages", t.dir, "error.tsx")),
+							loadPending: (t) => n(f(e, "src", "pages", t.dir, "loading.tsx")),
 							ctx: {
-								params: u.params,
+								params: l.params,
 								pathname: c,
 								signal: C.signal,
 								headers: b,
 								query: S
 							}
-						})));
-						let e = o.loader;
-						typeof e == "function" && !y && (T = await h("loader", () => e({
-							params: u.params,
+						}));
+						let t = s.loader;
+						typeof t == "function" && !y && (T = await h("loader", () => t({
+							params: l.params,
 							pathname: c,
 							signal: C.signal,
 							headers: b,
 							query: S
 						})));
 					} finally {
-						r.off("close", w);
+						i.off("close", w);
 					}
-					let O = await h("loadSsrHelpers", async () => await t("@voltro/web/ssr")), k = {
-						pattern: u.route.pattern,
-						Component: o.default,
-						meta: o.meta,
-						loader: o.loader,
-						ErrorBoundary: o.ErrorBoundary,
-						Pending: o.Pending,
+					let O = await h("loadSsrHelpers", async () => await n("@voltro/web/ssr")), k = {
+						pattern: l.route.pattern,
+						Component: s.default,
+						meta: s.meta,
+						loader: s.loader,
+						ErrorBoundary: s.ErrorBoundary,
+						Pending: s.Pending,
 						renderMode: _,
 						chain: E
 					}, A = {
 						cookies: O.parseCookieHeader(b.cookie),
 						headers: b,
-						url: a
-					}, j = o.interactive ?? "full", M = y ? hr({
+						url: o
+					}, j = s.interactive ?? "full", M = y ? Cr({
 						helpers: O,
-						page: `src/pages/${u.route.file}`,
+						page: `src/pages/${l.route.file}`,
 						interactive: j,
 						delivery: "stream",
 						renderInput: {
 							descriptor: k,
-							params: u.params,
+							params: l.params,
 							pathname: c,
 							segmentLoaderData: D,
 							requestContext: A
 						}
-					}) : null, N = y ? null : mr({
+					}) : null, N = y ? null : Sr({
 						helpers: O,
-						page: `src/pages/${u.route.file}`,
+						page: `src/pages/${l.route.file}`,
 						pathname: c,
 						renderMode: _,
 						interactive: j,
 						loaderData: T,
 						segmentLoaderData: D,
-						pageLoaderRan: typeof o.loader == "function"
+						pageLoaderRan: typeof s.loader == "function"
 					}), P = [];
 					await h("collectCss", async () => {
-						let e = /* @__PURE__ */ new Set(), t = [
-							l(s, "src", "pages", u.route.file),
-							...v.flatMap((e) => [
-								...e.hasLayout ? [l(s, "src", "pages", e.dir, "layout.tsx")] : [],
-								...e.hasError ? [l(s, "src", "pages", e.dir, "error.tsx")] : [],
-								...e.hasPending ? [l(s, "src", "pages", e.dir, "loading.tsx")] : []
+						let t = /* @__PURE__ */ new Set(), n = [
+							f(e, "src", "pages", l.route.file),
+							...v.flatMap((t) => [
+								...t.hasLayout ? [f(e, "src", "pages", t.dir, "layout.tsx")] : [],
+								...t.hasError ? [f(e, "src", "pages", t.dir, "error.tsx")] : [],
+								...t.hasPending ? [f(e, "src", "pages", t.dir, "loading.tsx")] : []
 							]),
-							l(s, ".framework", "main.tsx")
+							f(e, ".framework", "main.tsx")
 						];
-						for (let n of t) await g(n, e, P);
+						for (let e of n) await g(e, t, P);
 					});
-					let ee = await h("readShell", ve), F = await h("transformShell", () => e.transformIndexHtml(a, ee)), te = P.map((e) => `<link rel="stylesheet" href="${e}?direct" />`).join("\n    "), I = A.cookies["voltro:locale"] ?? "en", L = Date.now();
+					let ee = await h("readShell", _e), F = await h("transformShell", () => t.transformIndexHtml(o, ee)), te = P.map((e) => `<link rel="stylesheet" href="${e}?direct" />`).join("\n    "), I = A.cookies["voltro:locale"] ?? "en", L = Date.now();
 					if (M) {
-						let e = (e) => _r({
+						let e = (e) => Tr({
 							helpers: O,
 							prepared: M,
 							meta: e,
 							interactive: j,
 							extra: [te]
 						});
-						if (M.hasDeferred) Er({
-							res: r,
-							shell: wr({
+						if (M.hasDeferred) Pr({
+							res: i,
+							shell: Mr({
 								shell: F,
 								inlineModuleScriptsAsync: !0
 							}),
@@ -3058,16 +3077,16 @@ import {
 							onShellError: (e) => {
 								Z.warn("spa-shell-dev shell render failed; falling back to SPA shell", {
 									pathname: c,
-									pattern: u.route.pattern
-								}, e), i();
+									pattern: l.route.pattern
+								}, e), a();
 							}
 						});
 						else {
-							let t = gr({
+							let t = wr({
 								helpers: O,
 								prepared: M
 							}), n = F.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="${I}"`);
-							r.statusCode = 200, r.setHeader("content-type", "text/html; charset=utf-8"), r.setHeader("x-voltro-rendered-by", "spa-shell-dev"), r.end(n);
+							i.statusCode = 200, i.setHeader("content-type", "text/html; charset=utf-8"), i.setHeader("x-voltro-rendered-by", "spa-shell-dev"), i.end(n);
 						}
 					} else if (N) {
 						let e = (e) => [
@@ -3078,15 +3097,15 @@ import {
 							O.renderRouterStateScript(N.stateInput)
 						].filter((e) => e.length > 0).join("\n    "), t = {
 							descriptor: k,
-							params: u.params,
+							params: l.params,
 							pathname: c,
 							loaderData: N.loaderData,
 							segmentLoaderData: N.segmentLoaderData,
 							requestContext: A
 						};
-						if (_ === "ssr" && j === "full") Er({
-							res: r,
-							shell: wr({
+						if (_ === "ssr" && j === "full") Pr({
+							res: i,
+							shell: Mr({
 								shell: F,
 								inlineModuleScriptsAsync: !0
 							}),
@@ -3103,142 +3122,142 @@ import {
 							onShellError: (e) => {
 								Z.warn("ssr-dev shell render failed; falling back to SPA shell", {
 									pathname: c,
-									pattern: u.route.pattern
-								}, e), i();
+									pattern: l.route.pattern
+								}, e), a();
 							}
 						});
 						else {
-							let { html: n, meta: i } = O.renderPageToHtml(t), a = F.replace("<div id=\"root\"></div>", `<div id="root">${n}</div>`).replace("</head>", `    ${e(i)}\n  </head>`).replace(/<html(\s+lang="[^"]*")?/i, `<html lang="${I}"`);
-							r.statusCode = 200, r.setHeader("content-type", "text/html; charset=utf-8"), r.setHeader("x-voltro-rendered-by", "ssr-dev"), r.end(a);
+							let { html: n, meta: r } = O.renderPageToHtml(t), a = F.replace("<div id=\"root\"></div>", `<div id="root">${n}</div>`).replace("</head>", `    ${e(r)}\n  </head>`).replace(/<html(\s+lang="[^"]*")?/i, `<html lang="${I}"`);
+							i.statusCode = 200, i.setHeader("content-type", "text/html; charset=utf-8"), i.setHeader("x-voltro-rendered-by", "ssr-dev"), i.end(a);
 						}
 					}
 					m.render = Date.now() - L;
-					let R = Date.now() - f;
-					d ? (B.add(u.route.pattern), Z.info(`ssr compiled ${u.route.pattern} in ${R}ms`, {
-						pattern: u.route.pattern,
+					let R = Date.now() - p;
+					d ? (pe.add(l.route.pattern), Z.info(`ssr compiled ${l.route.pattern} in ${R}ms`, {
+						pattern: l.route.pattern,
 						pathname: c,
 						elapsedMs: R,
 						cold: !0,
 						phases: m
 					})) : R > 200 && Z.info(`ssr rendered ${c} in ${R}ms`, {
-						pattern: u.route.pattern,
+						pattern: l.route.pattern,
 						pathname: c,
 						elapsedMs: R,
 						cold: !1,
 						phases: m
 					});
 				} catch (e) {
-					if (pr(e)) {
+					if (xr(e)) {
 						Z.error("ssr-dev render refused", {
 							pathname: c,
-							pattern: u.route.pattern
-						}, e), r.statusCode = 500, r.setHeader("content-type", "text/plain; charset=utf-8"), r.end(e.message);
+							pattern: l.route.pattern
+						}, e), i.statusCode = 500, i.setHeader("content-type", "text/plain; charset=utf-8"), i.end(e.message);
 						return;
 					}
 					Z.warn("ssr-dev render failed; falling back to SPA shell", {
 						pathname: c,
-						pattern: u.route.pattern
-					}, e), i();
+						pattern: l.route.pattern
+					}, e), a();
 				}
 			});
 		}
-	}, V = Date.now(), be = E.version ?? "?", xe = await kr(), H = l(s, "node_modules", "@voltro", "ui-shadcn"), U = T(l(H, "package.json")) ? H : null, Se = [], Ce = await (async () => {
-		let e = [];
-		for (let t of p) {
-			if (!t.proxyTarget) continue;
-			let n = await Zr(s, t.pkg);
-			if (n) try {
-				e.push(await O.readFile(l(n, "rpcGroup.generated.ts"), "utf8"));
+	}, ye = Date.now(), H = w.version ?? "?", U = await Lr(), be = f(e, "node_modules", "@voltro", "ui-shadcn"), W = O(f(be, "package.json")) ? be : null, xe = [], G = await (async () => {
+		let t = [];
+		for (let n of u) {
+			if (!n.proxyTarget) continue;
+			let r = await ii(e, n.pkg);
+			if (r) try {
+				t.push(await j.readFile(f(r, "rpcGroup.generated.ts"), "utf8"));
 			} catch {}
 		}
-		if (e.length === 0) return !1;
-		let t = pe("sha1").update(e.join("\0")).digest("hex"), n = l(A, ".voltro-rpcgroup-optimize"), r = "";
+		if (t.length === 0) return !1;
+		let n = he("sha1").update(t.join("\0")).digest("hex"), r = f(k, ".voltro-rpcgroup-optimize"), i = "";
 		try {
-			r = (await O.readFile(n, "utf8")).trim();
+			i = (await j.readFile(r, "utf8")).trim();
 		} catch {}
-		if (r === t) return !1;
+		if (i === n) return !1;
 		try {
-			await O.writeFile(n, t);
+			await j.writeFile(r, n);
 		} catch {}
 		return !0;
 	})();
-	Ce && Z.info("rpcGroup changed since last boot — forcing a dep re-optimize so the browser loads the current api client"), await (await E.createServer({
-		root: A,
+	G && Z.info("rpcGroup changed since last boot — forcing a dep re-optimize so the browser loads the current api client"), await (await w.createServer({
+		root: k,
 		envPrefix: "__VOLTRO_VITE_ENV_DISABLED__",
 		ssr: { noExternal: ["react-intl"] },
 		resolve: {
 			dedupe: ["react", "react-dom"],
 			alias: [
-				...xe ? [{
+				...U ? [{
 					find: "@voltro/devtools/styles.css",
-					replacement: l(xe, "src/styles.css")
+					replacement: f(U, "src/styles.css")
 				}, {
 					find: "@voltro/devtools",
-					replacement: l(xe, "src/index.ts")
+					replacement: f(U, "src/index.ts")
 				}] : [],
-				...U ? [
+				...W ? [
 					{
 						find: "@voltro/ui-shadcn/tokens.css",
-						replacement: l(U, "src/tokens.css")
+						replacement: f(W, "src/tokens.css")
 					},
 					{
 						find: "@voltro/ui-shadcn/cn",
-						replacement: l(U, "src/cn.ts")
+						replacement: f(W, "src/cn.ts")
 					},
 					{
 						find: "@voltro/ui-shadcn/brand",
-						replacement: l(U, "src/brand/voltroLogo.tsx")
+						replacement: f(W, "src/brand/voltroLogo.tsx")
 					},
 					{
 						find: "@voltro/ui-shadcn",
-						replacement: l(U, "src/index.ts")
+						replacement: f(W, "src/index.ts")
 					}
 				] : [],
-				...Ue(s)
+				...We(e)
 			]
 		},
 		optimizeDeps: {
-			include: [...p.map((e) => `${e.pkg}/rpcGroup`), ...Se],
-			force: Ce
+			include: [...u.map((e) => `${e.pkg}/rpcGroup`), ...xe],
+			force: G
 		},
-		customLogger: vt(),
+		customLogger: xt(),
 		plugins: [
-			xn(l(s, "src", "pages")),
+			Dn(f(e, "src", "pages")),
+			T(),
 			D(),
-			k(),
 			N,
 			I,
 			ae,
+			se,
 			ce,
-			le,
 			ue,
-			ye,
+			ve,
 			...de ? [de] : []
 		],
 		server: {
 			port: g,
 			strictPort: !0,
 			host: !0,
-			allowedHosts: c.allowedHosts === !0 || [...c.allowedHosts ?? []],
+			allowedHosts: t.allowedHosts === !0 || [...t.allowedHosts ?? []],
 			proxy: z,
-			fs: { allow: [s, ...Fr(s)] }
+			fs: { allow: [e, ...Ur(e)] }
 		},
 		appType: "spa",
-		cacheDir: l(A, ".vite"),
-		publicDir: l(s, "public")
-	})).listen(), Dr.info(`v${be} ready in ${Date.now() - V}ms`, {
-		version: be,
-		bootMs: Date.now() - V
+		cacheDir: f(k, ".vite"),
+		publicDir: f(e, "public")
+	})).listen(), Fr.info(`v${H} ready in ${Date.now() - ye}ms`, {
+		version: H,
+		bootMs: Date.now() - ye
 	}), Z.info(`listening on http://localhost:${g}`, {
 		port: g,
-		app: c.name ?? "(unnamed)"
+		app: t.name ?? "(unnamed)"
 	});
-	for (let e of p) e.proxyTarget && (Z.info(`proxy /ws/${e.name} → ${e.proxyTarget}`, {
+	for (let e of u) e.proxyTarget && (Z.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 }));
 	try {
-		await Hn({
+		await Yn({
 			id: v,
 			name: _,
 			kind: "web",
@@ -3247,13 +3266,13 @@ import {
 			status: "live",
 			logFile: y.path
 		});
-		let e = nr(s);
-		if (e) {
-			let t = await dr({ dashboardAppPath: e });
-			t.status === "launched" ? Z.info(`dashboard launched at http://localhost:${t.port}`, { port: t.port }) : t.status === "already-running" && Z.debug(`dashboard already running on :${t.port}`, { port: t.port });
+		let t = lr(e);
+		if (t) {
+			let e = await yr({ 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 });
 		}
 		setInterval(() => {
-			Hn({
+			Yn({
 				id: v,
 				name: _,
 				kind: "web",
@@ -3263,78 +3282,78 @@ import {
 				logFile: y.path
 			}).catch(() => {});
 		}, 1e4).unref();
-		let t = () => {
-			Un(v), y.dispose();
+		let n = () => {
+			Xn(v), y.dispose();
 		};
-		process.on("SIGINT", t), process.on("SIGTERM", t);
+		process.on("SIGINT", n), process.on("SIGTERM", n);
 	} catch (e) {
 		Z.warn("runtime-registry write failed", {}, e);
 	}
-	return C({
-		app: c.name ?? "unnamed",
+	return E({
+		app: t.name ?? "unnamed",
 		kind: "web",
 		url: `http://localhost:${g}`,
-		bootMs: Date.now() - V
+		bootMs: Date.now() - ye
 	}), new Promise(() => {});
-}, pi = async (e) => {
+}, bi = async (e) => {
 	process.env.NODE_ENV || (process.env.NODE_ENV = "production");
-	let t = await di(e);
+	let t = await vi(e);
 	if (!t) return {
 		ran: !1,
 		exitCode: 0
 	};
 	let n = Date.now(), r = Z.child("serve");
 	r.info("booting voltro serve (preview)", { app: t.name ?? "(unnamed)" });
-	let i = await ni(e, t);
+	let i = await li(e, t);
 	for (let e of i) r.info("api wired", {
 		name: e.name,
 		pkg: e.pkg
 	});
-	await ci(e, t, i);
+	await hi(e, t, i);
 	{
-		let { pages: t } = await $(l(e, "src", "pages"));
-		await jt({
+		let { pages: t } = await $(f(e, "src", "pages"));
+		await Pt({
 			appRoot: e,
 			pages: t
 		});
 	}
-	let a = t.port ?? 5173, o = await Ge("vite", () => import("vite")), s = (await import("@vitejs/plugin-react")).default, c = l(e, ".framework");
+	let a = t.port ?? 5173, o = await Ke("vite", () => import("vite")), s = (await import("@vitejs/plugin-react")).default, c = f(e, ".framework");
 	Z.info("running production build"), await o.build({
 		root: c,
 		envPrefix: "__VOLTRO_VITE_ENV_DISABLED__",
 		plugins: [s()],
-		customLogger: vt(),
+		customLogger: xt(),
 		resolve: { dedupe: ["react", "react-dom"] },
 		build: {
 			outDir: "dist",
-			rollupOptions: { output: { manualChunks: Rr } }
+			rollupOptions: { output: { manualChunks: Gr } }
 		},
-		publicDir: l(e, "public")
+		publicDir: f(e, "public")
 	});
-	let u = (await o.preview({
+	let l = (await o.preview({
 		root: c,
 		envPrefix: "__VOLTRO_VITE_ENV_DISABLED__",
 		preview: { port: a },
 		build: { outDir: "dist" }
-	})).resolvedUrls, d = u?.local[0] ?? `http://localhost:${a}`, f = u?.local.slice(1).map((e) => ({
+	})).resolvedUrls, u = l?.local[0] ?? `http://localhost:${a}`, d = l?.local.slice(1).map((e) => ({
 		label: "Local",
 		url: e
 	})) ?? [];
-	return C({
+	return E({
 		app: t.name ?? "unnamed",
 		kind: "preview",
-		url: d,
-		extras: f,
+		url: u,
+		extras: d,
 		bootMs: Date.now() - n
 	}), new Promise(() => {});
-}, mi = 5e3, hi = 6e4, gi = (e, t) => {
+}, xi = 5e3, Si = 6e4, Ci = (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;
-}, _i = (e) => {
+}, wi = (e) => {
 	if (e.length === 0) return {
 		p50: 0,
 		p95: 0,
@@ -3346,18 +3365,18 @@ import {
 	let t = e.slice().sort((e, t) => e - t), n = 0;
 	for (let e of t) n += e;
 	return {
-		p50: gi(t, .5),
-		p95: gi(t, .95),
-		p99: gi(t, .99),
+		p50: Ci(t, .5),
+		p95: Ci(t, .95),
+		p99: Ci(t, .99),
 		mean: n / t.length,
 		min: t[0],
 		max: t[t.length - 1]
 	};
-}, vi = (e = {}) => {
-	let t = e.maxSamples ?? mi, n = e.defaultWindowMs ?? hi, r = [];
+}, Ti = (e = {}) => {
+	let t = e.maxSamples ?? xi, n = e.defaultWindowMs ?? Si, r = [];
 	return {
 		record(e) {
-			te(e), r.push({
+			R(e), r.push({
 				...e,
 				ts: Date.now()
 			}), r.length > t && r.shift();
@@ -3383,7 +3402,7 @@ import {
 					tag: e.tag,
 					count: e.samples.length,
 					errorCount: n,
-					latencyMs: _i(t)
+					latencyMs: wi(t)
 				});
 			}
 			return c.sort((e, t) => t.count - e.count), {
@@ -3396,4 +3415,4 @@ import {
 	};
 };
 //#endregion
-export { it as $, Un as A, Xt as B, dr as C, Qn as D, Zn as E, Tn as F, Ft as G, Vt as H, Dn as I, yt as J, jt as K, cn as L, Sn as M, On as N, Wn as O, Cn as P, rt as Q, nn as R, tr as S, Xn as T, Pt as U, Ut as V, Nt as W, ct as X, ut as Y, st as Z, mr as _, Gr as a, Qe as at, _r as b, ni as c, Ge as ct, Rr as d, Ve as dt, at as et, $ as f, V as ft, pr as g, Er as h, si as i, tt as it, Hn as j, Vn as k, fi as l, Ue as lt, wr as m, zr as n, K as nt, Wr as o, Xe as ot, ci as p, be as pt, xt as q, oi as r, et as rt, di as s, Ye as st, vi as t, nt as tt, pi as u, Be as ut, hr as v, nr as w, rr as x, gr as y, Qt as z };
+export { ut as $, Xn as A, dn as B, yr as C, ar as D, ir as E, jn as F, Wt as G, tn as H, Nn as I, Rt as J, Lt as K, gn as L, On as M, Pn as N, Zn as O, kn as P, ft as Q, _n as R, cr as S, rr as T, $t as U, on as V, Kt as W, wt as X, Pt as Y, St as Z, Sr as _, Qr as a, J as at, Tr as b, li as c, $e as ct, Gr as d, Ke as dt, lt as et, $ as f, We as ft, xr as g, W as gt, Pr as h, be as ht, mi as i, rt as it, Yn as j, Jn as k, yi as l, Ze as lt, Mr as m, He as mt, Kr as n, at as nt, Zr as o, tt as ot, hi as p, Ve as pt, It as q, pi as r, ot as rt, vi as s, nt as st, Ti as t, it as tt, bi as u, Xe as ut, Cr as v, lr as w, ur as x, wr as y, vn as z };