@voltro/web 0.55.0 → 0.56.0

package/dist/{frameworkBoot-CnE9vzLQ.js → frameworkBoot-BfJpdpZp.js}

@@ -1,20 +1,20 @@
 import { t as e } from "./globalContext-AuflFFmy.js";
 import { AppClientsContext as t } from "./hooks.js";
 import { c as n, l as r, r as i, s as a, u as o } from "./defaultFallbacks-SQ45vAhz.js";
-import { useCallback as s, useContext as c, useEffect as l, useRef as u, useState as d, useSyncExternalStore as f } from "react";
-import { FrameworkRuntimesProvider as p, buildApiRuntime as m, ssrClientProxy as h, ssrStubHandle as ee, startApiSupervisor as g, subscribeClientTraces as te, wireAuthRefresh as ne } from "@voltro/client";
-import { Fragment as re, jsx as _, jsxs as v } from "react/jsx-runtime";
+import { useCallback as s, useContext as c, useEffect as l, useMemo as u, useRef as d, useState as f, useSyncExternalStore as p } from "react";
+import { FrameworkRuntimesProvider as ee, buildApiRuntime as m, ssrClientProxy as te, ssrStubHandle as ne, startApiSupervisor as re, subscribeClientTraces as ie, wireAuthRefresh as ae } from "@voltro/client";
+import { Fragment as h, jsx as g, jsxs as _ } from "react/jsx-runtime";
 //#region src/reconnect.ts
-var y = e("reconnect", null), b = () => c(y) ?? (() => {}), x = 150, S = 220, C = () => {
-	let e = f(o, n, n).some((e) => e.kind === "loading" || e.kind === "reconnecting"), [t, r] = d(!1);
+var v = e("reconnect", null), y = () => c(v) ?? (() => {}), b = 150, x = 220, S = () => {
+	let e = p(o, n, n).some((e) => e.kind === "loading" || e.kind === "reconnecting"), [t, r] = f(!1);
 	return l(() => {
 		if (!e) {
 			r(!1);
 			return;
 		}
-		let t = setTimeout(() => r(!0), x);
+		let t = setTimeout(() => r(!0), b);
 		return () => clearTimeout(t);
-	}, [e]), /* @__PURE__ */ v("div", {
+	}, [e]), /* @__PURE__ */ _("div", {
 		"aria-hidden": "true",
 		"data-voltro-nav-indicator": "",
 		style: {
@@ -25,7 +25,7 @@ var y = e("reconnect", null), b = () => c(y) ?? (() => {}), x = 150, S = 220, C
 			pointerEvents: "none",
 			opacity: +!!t,
 			transform: t ? "translateY(0) scale(1)" : "translateY(4px) scale(0.96)",
-			transition: `opacity ${S}ms ease, transform ${S}ms ease`,
+			transition: `opacity ${x}ms ease, transform ${x}ms ease`,
 			display: "grid",
 			placeItems: "center",
 			width: 34,
@@ -37,51 +37,51 @@ var y = e("reconnect", null), b = () => c(y) ?? (() => {}), x = 150, S = 220, C
 			border: "1px solid color-mix(in oklch, canvastext 12%, transparent)",
 			boxShadow: "0 4px 14px color-mix(in oklch, canvastext 16%, transparent)"
 		},
-		children: [/* @__PURE__ */ _("span", { "data-voltro-nav-spinner": "" }), /* @__PURE__ */ _("style", { children: w })]
+		children: [/* @__PURE__ */ g("span", { "data-voltro-nav-spinner": "" }), /* @__PURE__ */ g("style", { children: C })]
 	});
-}, w = "\n@keyframes voltroNavSpin { to { transform: rotate(360deg); } }\n[data-voltro-nav-spinner] {\n  width: 16px;\n  height: 16px;\n  border-radius: 50%;\n  border: 2px solid color-mix(in oklch, canvastext 22%, transparent);\n  border-top-color: color-mix(in oklch, canvastext 78%, transparent);\n  animation: voltroNavSpin 0.7s linear infinite;\n}\n@media (prefers-reduced-motion: reduce) {\n  [data-voltro-nav-spinner] { animation-duration: 1.6s; }\n}\n", T = 2e3, ie = () => typeof window < "u" && !1, ae = () => typeof window > "u" ? null : `${window.location.origin}/`, oe = 2e4, E = "voltro:wedge-reload-at", se = () => {
+}, C = "\n@keyframes voltroNavSpin { to { transform: rotate(360deg); } }\n[data-voltro-nav-spinner] {\n  width: 16px;\n  height: 16px;\n  border-radius: 50%;\n  border: 2px solid color-mix(in oklch, canvastext 22%, transparent);\n  border-top-color: color-mix(in oklch, canvastext 78%, transparent);\n  animation: voltroNavSpin 0.7s linear infinite;\n}\n@media (prefers-reduced-motion: reduce) {\n  [data-voltro-nav-spinner] { animation-duration: 1.6s; }\n}\n", w = 2e3, T = () => typeof window < "u" && !1, E = () => typeof window > "u" ? null : `${window.location.origin}/`, D = 2e4, O = "voltro:wedge-reload-at", k = () => {
 	try {
-		let e = Number(window.sessionStorage.getItem(E) ?? "0"), t = Date.now();
-		if (t - e < oe) return;
-		window.sessionStorage.setItem(E, String(t));
+		let e = Number(window.sessionStorage.getItem(O) ?? "0"), t = Date.now();
+		if (t - e < D) return;
+		window.sessionStorage.setItem(O, String(t));
 	} catch {}
 	window.location.reload();
-}, D = () => {
-	if (ie()) return {
+}, A = () => {
+	if (T()) return {
 		afterFailures: 2,
 		arm: () => {
-			let e = ae();
+			let e = E();
 			if (e === null) return () => {};
 			let t = setInterval(() => {
 				fetch(e, {
 					method: "GET",
 					cache: "no-store",
-					signal: AbortSignal.timeout(T)
+					signal: AbortSignal.timeout(w)
 				}).then((e) => {
-					e.status < 500 && se();
+					e.status < 500 && k();
 				}).catch(() => {});
-			}, T);
+			}, w);
 			return () => clearInterval(t);
 		}
 	};
-}, O = {
+}, j = {
 	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)
-}, k = 200, A = 400, ce = 20, j = 1e3, M = (e) => {
+}, M = 200, oe = 400, se = 20, N = 1e3, P = (e) => {
 	if (typeof e == "string") return e;
 	if (e === void 0) return "undefined";
 	if (e === null) return "null";
 	if (e instanceof Error) return e.stack ?? e.message;
 	if (typeof e == "object") try {
-		return JSON.stringify(e, le());
+		return JSON.stringify(e, ce());
 	} catch {
 		return Object.prototype.toString.call(e);
 	}
 	return String(e);
-}, le = () => {
+}, ce = () => {
 	let e = /* @__PURE__ */ new WeakSet();
 	return (t, n) => {
 		if (typeof n == "object" && n) {
@@ -90,20 +90,20 @@ var y = e("reconnect", null), b = () => c(y) ?? (() => {}), x = 150, S = 220, C
 		}
 		return n;
 	};
-}, N = (e, t) => e.length > t ? `${e.slice(0, t)}…` : e, P = /%[sdifoOc]/g, F = (e) => {
+}, F = (e, t) => e.length > t ? `${e.slice(0, t)}…` : e, I = /%[sdifoOc]/g, L = (e) => {
 	if (e.length === 0) return {
 		message: "",
 		rest: []
 	};
 	let t = e[0];
-	if (typeof t != "string" || !P.test(t)) return {
-		message: M(t),
+	if (typeof t != "string" || !I.test(t)) return {
+		message: P(t),
 		rest: e.slice(1)
 	};
-	P.lastIndex = 0;
+	I.lastIndex = 0;
 	let n = 1;
 	return {
-		message: t.replace(P, (t) => {
+		message: t.replace(I, (t) => {
 			if (t === "%c") return n++, "";
 			if (n >= e.length) return t;
 			let r = e[n++];
@@ -119,21 +119,21 @@ var y = e("reconnect", null), b = () => c(y) ?? (() => {}), x = 150, S = 220, C
 					return Number.isFinite(e) ? String(e) : "NaN";
 				}
 				case "%o":
-				case "%O": return M(r);
+				case "%O": return P(r);
 				default: return t;
 			}
 		}),
 		rest: e.slice(n)
 	};
-}, I = (e) => {
-	let t = e.flushAfterMs ?? A, n = `${e.baseUrl.replace(/\/+$/, "")}/_voltro/inspect/clientLog`, r = [], i = null, a = !1, o = () => {
+}, R = (e) => {
+	let t = e.flushAfterMs ?? oe, n = `${e.baseUrl.replace(/\/+$/, "")}/_voltro/inspect/clientLog`, r = [], i = null, a = !1, o = () => {
 		if (i !== null && (clearTimeout(i), i = null), r.length === 0) return;
 		let t = r;
 		r = [];
 		let a = {
 			app: e.appName,
 			page: typeof window < "u" ? window.location.pathname : void 0,
-			ua: typeof navigator < "u" ? N(navigator.userAgent, 200) : void 0,
+			ua: typeof navigator < "u" ? F(navigator.userAgent, 200) : void 0,
 			entries: t
 		};
 		try {
@@ -149,11 +149,11 @@ var y = e("reconnect", null), b = () => c(y) ?? (() => {}), x = 150, S = 220, C
 		i === null && (i = setTimeout(o, t));
 	}, c = (e, t) => {
 		if (a) return;
-		r.length >= k && r.shift();
+		r.length >= M && r.shift();
 		let n = t.find((e) => e instanceof Error), i = t.find((e) => typeof e == "object" && !!e && "componentStack" in e), c = typeof i?.componentStack == "string" ? i.componentStack : void 0, l = t[0] instanceof Error ? {
 			message: t[0].message,
 			rest: t.slice(1)
-		} : F(t), u = N(l.message, j), d = l.rest.filter((e) => e !== n && e !== i).map((e) => N(M(e), j)), f;
+		} : L(t), u = F(l.message, N), d = l.rest.filter((e) => e !== n && e !== i).map((e) => F(P(e), N)), f;
 		n ? (f = n.stack ?? n.message, c && (f += `\n\nComponent stack:${c}`)) : e === "error" && (f = (/* @__PURE__ */ Error()).stack);
 		let p = {
 			ts: Date.now(),
@@ -162,29 +162,29 @@ var y = e("reconnect", null), b = () => c(y) ?? (() => {}), x = 150, S = 220, C
 			...d.length > 0 ? { args: d } : {},
 			...f === void 0 ? {} : { stack: f }
 		};
-		r.push(p), r.length >= ce ? o() : s();
+		r.push(p), r.length >= se ? o() : s();
 	}, l = (e) => (...t) => {
-		O[e](...t), c(e, t);
+		j[e](...t), c(e, t);
 	};
 	console.log = l("log"), console.info = l("info"), console.warn = l("warn"), console.error = l("error"), console.debug = l("debug");
 	let u = () => {
 		o();
 	};
 	return typeof window < "u" && (window.addEventListener("beforeunload", u), window.addEventListener("pagehide", u)), { dispose: () => {
-		a = !0, o(), i !== null && (clearTimeout(i), i = null), console.log = O.log, console.info = O.info, console.warn = O.warn, console.error = O.error, console.debug = O.debug, typeof window < "u" && (window.removeEventListener("beforeunload", u), window.removeEventListener("pagehide", u));
+		a = !0, o(), i !== null && (clearTimeout(i), i = null), console.log = j.log, console.info = j.info, console.warn = j.warn, console.error = j.error, console.debug = j.debug, typeof window < "u" && (window.removeEventListener("beforeunload", u), window.removeEventListener("pagehide", u));
 	} };
-}, L = 500, R = /* @__PURE__ */ new Set(), z = (e) => {
-	if (!R.has(e) && (R.add(e), R.size > L)) {
-		let e = R.values().next().value;
-		e !== void 0 && R.delete(e);
+}, le = 500, z = /* @__PURE__ */ new Set(), B = (e) => {
+	if (!z.has(e) && (z.add(e), z.size > le)) {
+		let e = z.values().next().value;
+		e !== void 0 && z.delete(e);
 	}
-}, B = /* @__PURE__ */ new Set(), V = (e) => (B.add(e), () => {
-	B.delete(e);
-}), H = (e) => {
-	for (let t of B) try {
+}, V = /* @__PURE__ */ new Set(), H = (e) => (V.add(e), () => {
+	V.delete(e);
+}), U = (e) => {
+	for (let t of V) try {
 		t(e);
 	} catch {}
-}, U = {
+}, ue = {
 	log: "log",
 	info: "info",
 	warn: "warn",
@@ -203,21 +203,21 @@ var y = e("reconnect", null), b = () => c(y) ?? (() => {}), x = 150, S = 220, C
 			try {
 				let n = JSON.parse(t.data).payload;
 				if (!n || typeof n.message != "string" || n.scope === "client") return;
-				let r = n.level === void 0 ? "log" : U[n.level], i = n.scope ? ` ${n.scope}` : "";
-				O[r](`%c[server ${e.originLabel}${i}]%c ${n.message}`, W[r], "", ...n.fields ? [n.fields] : []);
+				let r = n.level === void 0 ? "log" : ue[n.level], i = n.scope ? ` ${n.scope}` : "";
+				j[r](`%c[server ${e.originLabel}${i}]%c ${n.message}`, W[r], "", ...n.fields ? [n.fields] : []);
 			} catch {}
 		}), n.addEventListener("trace", (t) => {
 			try {
 				let n = JSON.parse(t.data).payload;
-				if (!n || n.status !== "error" || typeof n.traceId != "string" || !R.has(n.traceId)) return;
+				if (!n || n.status !== "error" || typeof n.traceId != "string" || !z.has(n.traceId)) return;
 				let r = n.name ?? "span", i = n.statusMessage && n.statusMessage.length > 0 ? n.statusMessage : `${r} failed`;
-				H({
+				U({
 					traceId: n.traceId,
 					spanName: r,
 					api: e.originLabel,
 					message: i,
 					ts: Date.now()
-				}), O.error(`%c[trace ${e.originLabel}]%c ${r} failed — ${i} (trace ${n.traceId})`, W.error, "");
+				}), j.error(`%c[trace ${e.originLabel}]%c ${r} failed — ${i} (trace ${n.traceId})`, W.error, "");
 			} catch {}
 		}), n.addEventListener("error", () => {
 			n && n.readyState === EventSource.CLOSED && (n = null, !r && i === null && (i = setTimeout(() => {
@@ -236,20 +236,20 @@ var y = e("reconnect", null), b = () => c(y) ?? (() => {}), x = 150, S = 220, C
 	muted: "oklch(0.65 0.012 285)",
 	danger: "oklch(0.7 0.21 22)",
 	dangerDim: "oklch(0.5 0.18 22 / 25%)"
-}, q = "ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', monospace", ue = "ui-sans-serif, system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif", de = 0, fe = () => {
-	let [e, t] = d([]);
-	if (l(() => V((e) => {
+}, q = "ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', monospace", de = "ui-sans-serif, system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif", fe = 0, pe = () => {
+	let [e, t] = f([]);
+	if (l(() => H((e) => {
 		t((t) => {
 			if (t.some((t) => t.traceId === e.traceId && t.spanName === e.spanName)) return t;
 			let n = [...t, {
 				...e,
-				id: ++de
+				id: ++fe
 			}];
 			return n.length > 4 ? n.slice(n.length - 4) : n;
 		});
 	}), []), e.length === 0) return null;
 	let n = (e) => t((t) => t.filter((t) => t.id !== e));
-	return /* @__PURE__ */ _("div", {
+	return /* @__PURE__ */ g("div", {
 		style: {
 			position: "fixed",
 			right: 16,
@@ -259,17 +259,17 @@ var y = e("reconnect", null), b = () => c(y) ?? (() => {}), x = 150, S = 220, C
 			flexDirection: "column",
 			gap: 10,
 			maxWidth: 380,
-			fontFamily: ue,
+			fontFamily: de,
 			pointerEvents: "none"
 		},
-		children: e.map((e) => /* @__PURE__ */ _(pe, {
+		children: e.map((e) => /* @__PURE__ */ g(me, {
 			toast: e,
 			onDismiss: () => n(e.id)
 		}, e.id))
 	});
-}, pe = ({ toast: e, onDismiss: t }) => {
-	let [n, r] = d(!1), a = `voltro logs --trace ${e.traceId}`;
-	return /* @__PURE__ */ v("div", {
+}, me = ({ toast: e, onDismiss: t }) => {
+	let [n, r] = f(!1), a = `voltro logs --trace ${e.traceId}`;
+	return /* @__PURE__ */ _("div", {
 		style: {
 			pointerEvents: "auto",
 			background: K.card,
@@ -283,14 +283,14 @@ var y = e("reconnect", null), b = () => c(y) ?? (() => {}), x = 150, S = 220, C
 			lineHeight: 1.45
 		},
 		children: [
-			/* @__PURE__ */ v("div", {
+			/* @__PURE__ */ _("div", {
 				style: {
 					display: "flex",
 					alignItems: "center",
 					justifyContent: "space-between",
 					gap: 8
 				},
-				children: [/* @__PURE__ */ _("span", {
+				children: [/* @__PURE__ */ g("span", {
 					style: {
 						color: K.danger,
 						fontWeight: 600,
@@ -298,7 +298,7 @@ var y = e("reconnect", null), b = () => c(y) ?? (() => {}), x = 150, S = 220, C
 						letterSpacing: .3
 					},
 					children: "⚠ Backend error"
-				}), /* @__PURE__ */ _("button", {
+				}), /* @__PURE__ */ g("button", {
 					onClick: t,
 					"aria-label": "Dismiss",
 					style: {
@@ -313,14 +313,14 @@ var y = e("reconnect", null), b = () => c(y) ?? (() => {}), x = 150, S = 220, C
 					children: "×"
 				})]
 			}),
-			/* @__PURE__ */ v("div", {
+			/* @__PURE__ */ _("div", {
 				style: {
 					marginTop: 6,
 					color: K.muted,
 					fontSize: 11.5
 				},
 				children: [
-					/* @__PURE__ */ _("span", {
+					/* @__PURE__ */ g("span", {
 						style: {
 							fontFamily: q,
 							color: K.fg
@@ -328,13 +328,13 @@ var y = e("reconnect", null), b = () => c(y) ?? (() => {}), x = 150, S = 220, C
 						children: e.api
 					}),
 					" · ",
-					/* @__PURE__ */ _("span", {
+					/* @__PURE__ */ g("span", {
 						style: { fontFamily: q },
 						children: e.spanName
 					})
 				]
 			}),
-			/* @__PURE__ */ _("div", {
+			/* @__PURE__ */ g("div", {
 				style: {
 					marginTop: 4,
 					color: K.fg,
@@ -342,7 +342,7 @@ var y = e("reconnect", null), b = () => c(y) ?? (() => {}), x = 150, S = 220, C
 				},
 				children: e.message
 			}),
-			/* @__PURE__ */ _("button", {
+			/* @__PURE__ */ g("button", {
 				onClick: () => {
 					i(a).then((e) => {
 						e !== "failed" && (r(!0), setTimeout(() => r(!1), 1500));
@@ -367,14 +367,14 @@ var y = e("reconnect", null), b = () => c(y) ?? (() => {}), x = 150, S = 220, C
 			})
 		]
 	});
-}, J = (e) => {
+}, he = (e) => {
 	try {
 		let t = new URL(e);
 		return `${t.protocol === "wss:" ? "https:" : "http:"}//${t.host}`;
 	} catch {
 		return "";
 	}
-}, Y = (e, t) => /^wss?:\/\//i.test(e) || /^https?:\/\//i.test(e) ? J(e) : `/_voltro/api/${t}`, me = typeof performance < "u" ? performance.now() : Date.now(), X = () => {
+}, J = (e, t) => /^wss?:\/\//i.test(e) || /^https?:\/\//i.test(e) ? he(e) : `/_voltro/api/${t}`, ge = typeof performance < "u" ? performance.now() : Date.now(), Y = () => {
 	if (typeof window > "u") return !1;
 	try {
 		if (window.localStorage?.getItem("framework_debug") === "1") return !0;
@@ -386,65 +386,84 @@ var y = e("reconnect", null), b = () => c(y) ?? (() => {}), x = 150, S = 220, C
 		PROD: !0,
 		SSR: !1
 	}.DEV === !0;
-}, Z = (e, ...t) => {
-	if (!X()) return;
-	let n = ((typeof performance < "u" ? performance.now() : Date.now()) - me).toFixed(0).padStart(6, " ");
+}, X = (e, ...t) => {
+	if (!Y()) return;
+	let n = ((typeof performance < "u" ? performance.now() : Date.now()) - ge).toFixed(0).padStart(6, " ");
 	console.log(`[fw ${e} +${n}ms]`, ...t);
-}, Q = 3e3, he = 0, ge = (e, t, n, r) => (i, a) => {
-	let o = ++he;
-	Z(e, `ws#${o} create gen=${t} url=${i}`);
+}, Z = 3e3, _e = 0, Q = (e, t, n, r) => (i, a) => {
+	let o = ++_e;
+	X(e, `ws#${o} create gen=${t} url=${i}`);
 	let s = new globalThis.WebSocket(i, a), c = !1, l = !1, u = (e) => {
 		l || (l = !0, r(e));
 	}, d = (t) => (n) => {
 		let r = t === "close" ? `code=${n.code}` : "type=error";
-		Z(e, `ws#${o} ${t} opened=${c} issued=${l} ${r}`), u(t);
+		X(e, `ws#${o} ${t} opened=${c} issued=${l} ${r}`), u(t);
 	};
 	return s.addEventListener("open", () => {
-		c = !0, Z(e, `ws#${o} open gen=${t}`), n();
+		c = !0, X(e, `ws#${o} open gen=${t}`), n();
 	}), s.addEventListener("close", d("close")), s.addEventListener("error", d("error")), setTimeout(() => {
 		if (!c && !l) {
-			Z(e, `ws#${o} connect-timeout gen=${t} (no open within ${Q}ms)`), u("connect-timeout");
+			X(e, `ws#${o} connect-timeout gen=${t} (no open within ${Z}ms)`), u("connect-timeout");
 			try {
 				s.close();
 			} catch {}
 		}
-	}, Q), s;
-}, _e = async (e, t, n, r) => {
-	Z(e.name, `build gen=${t}: making runtime`);
+	}, Z), s;
+}, ve = async (e, t, n, r) => {
+	X(e.name, `build gen=${t}: making runtime`);
 	try {
 		let i = await m({
 			name: e.name,
 			wsUrl: e.wsUrl,
 			group: e.group,
 			headers: e.headers,
-			webSocketConstructor: ge(e.name, t, n, r)
+			webSocketConstructor: Q(e.name, t, n, r)
 		});
-		return Z(e.name, `build gen=${t}: runtime resolved`), i;
+		return X(e.name, `build gen=${t}: runtime resolved`), i;
 	} catch (n) {
-		throw Z(e.name, `build gen=${t}: runtime FAILED, disposing`, n.message ?? n), n;
+		throw X(e.name, `build gen=${t}: runtime FAILED, disposing`, n.message ?? n), n;
 	}
-}, $ = ({ apis: e, children: n, chrome: i }) => {
-	let [o, c] = d(() => ({
+}, $ = ({ apis: e, children: n, chrome: i, connect: o = "eager" }) => {
+	let [c, p] = f(() => ({
 		initialized: e.length === 0,
 		clients: /* @__PURE__ */ new Map()
-	})), f = u(null), m = s(() => {
-		f.current?.reconnect();
-	}, []), [b, x] = d(!1);
+	})), m = d(null), y = s(() => {
+		m.current?.reconnect();
+	}, []), [b, x] = f(!1);
 	l(() => {
 		x(!0);
 	}, []), l(() => {
-		let e = [...o.clients.values()].map((e) => ne(e.errorBus, () => {
-			f.current?.refreshAuth();
+		let e = [...c.clients.values()].map((e) => ae(e.errorBus, () => {
+			m.current?.refreshAuth();
 		}));
 		return () => {
 			for (let t of e) t.dispose();
 		};
-	}, [o.clients]), l(() => {
-		let t = D(), n = g({
-			apis: e,
-			buildClient: _e,
+	}, [c.clients]);
+	let [C, w] = f(() => new Set(o === "eager" ? e.map((e) => e.name) : [])), T = s((e) => {
+		w((t) => t.has(e) ? t : /* @__PURE__ */ new Set([...t, e]));
+	}, []);
+	l(() => {
+		o === "eager" && w((t) => {
+			let n = new Set(t), r = !1;
+			for (let t of e) n.has(t.name) || (n.add(t.name), r = !0);
+			return r ? n : t;
+		});
+	}, [e, o]);
+	let E = u(() => e.filter((e) => C.has(e.name)), [e, C]);
+	l(() => {
+		if (E.length === 0) {
+			p({
+				clients: /* @__PURE__ */ new Map(),
+				initialized: !0
+			});
+			return;
+		}
+		let e = A(), t = re({
+			apis: E,
+			buildClient: ve,
 			onChange: (e, t) => {
-				c({
+				p({
 					clients: e,
 					initialized: t
 				});
@@ -454,67 +473,69 @@ var y = e("reconnect", null), b = () => c(y) ?? (() => {}), x = 150, S = 220, C
 				kind: "reconnecting",
 				label: "Reconnecting…"
 			}),
-			...t ? { wedgeBackstop: t } : {}
+			...e ? { wedgeBackstop: e } : {}
 		});
-		return f.current = n, () => {
-			n.dispose(), f.current === n && (f.current = null);
+		return m.current = t, () => {
+			t.dispose(), m.current === t && (m.current = null);
 		};
-	}, [e]), l(() => {
-		if (!X() || typeof window > "u") return;
+	}, [E]), l(() => {
+		if (!Y() || typeof window > "u") return;
 		let t = [], n = [], r = e[0]?.name ?? "web";
-		t.push(I({
+		t.push(R({
 			baseUrl: window.location.origin,
 			appName: r
 		}));
 		for (let t of e) {
-			let e = Y(t.wsUrl, t.name);
+			let e = J(t.wsUrl, t.name);
 			e.length !== 0 && n.push(G({
 				baseUrl: e,
 				originLabel: t.name
 			}));
 		}
-		let i = te((e) => z(e.traceId));
+		let i = ie((e) => B(e.traceId));
 		return () => {
 			for (let e of t) e.dispose();
 			for (let e of n) e.dispose();
 			i();
 		};
 	}, [e]);
-	let S = new Map(e.map((e) => [e.name, o.clients.get(e.name)?.client ?? h])), w = new Map(e.map((e) => {
-		let t = o.clients.get(e.name);
+	let D = new Map(e.map((e) => [e.name, c.clients.get(e.name)?.client ?? te])), O = new Map(e.map((e) => {
+		let t = c.clients.get(e.name);
 		return t ? [e.name, {
 			runtime: t.runtime,
 			cache: t.cache,
 			client: t.client,
 			descriptors: e.descriptors,
-			inspectBaseUrl: Y(e.wsUrl, e.name),
+			inspectBaseUrl: J(e.wsUrl, e.name),
 			errorBus: t.errorBus
 		}] : [e.name, {
-			...ee,
+			...ne,
 			descriptors: e.descriptors
 		}];
 	}));
-	return /* @__PURE__ */ _(y.Provider, {
-		value: m,
-		children: /* @__PURE__ */ _(p, {
-			apis: w,
-			children: /* @__PURE__ */ _(t.Provider, {
-				value: S,
-				children: /* @__PURE__ */ _(a, {
-					chrome: b ? /* @__PURE__ */ v(re, { children: [
-						/* @__PURE__ */ _(C, {}),
+	return /* @__PURE__ */ g(v.Provider, {
+		value: y,
+		children: /* @__PURE__ */ g(ee, {
+			apis: O,
+			...o === "lazy" ? { demand: T } : {},
+			children: /* @__PURE__ */ g(t.Provider, {
+				value: D,
+				children: /* @__PURE__ */ g(a, {
+					chrome: b ? /* @__PURE__ */ _(h, { children: [
+						/* @__PURE__ */ g(S, {}),
 						i,
-						X() ? /* @__PURE__ */ _(fe, {}) : null
+						Y() ? /* @__PURE__ */ g(pe, {}) : null
 					] }) : null,
 					children: n
 				})
 			})
 		})
 	});
-}, ve = ({ App: e, apis: t, Devtools: n }) => /* @__PURE__ */ _($, {
+}, ye = ({ App: e, apis: t, Devtools: n, connect: r }) => /* @__PURE__ */ g($, {
 	apis: t,
-	chrome: n ? /* @__PURE__ */ _(n, {}) : null,
-	children: /* @__PURE__ */ _(e, {})
+	chrome: n ? /* @__PURE__ */ g(n, {}) : null,
+	...r ? { connect: r } : {},
+	children: /* @__PURE__ */ g(e, {})
 });
 //#endregion
-export { G as a, C as c, I as i, y as l, $ as n, z as o, F as r, V as s, ve as t, b as u };
+export { G as a, S as c, R as i, v as l, $ as n, B as o, L as r, H as s, ye as t, y as u };

package/dist/frameworkBoot.d.ts

@@ -5,7 +5,7 @@ import { ReactNode } from 'react';
 
 export { ClientDescriptorMap }
 
-export declare const FrameworkBoot: ({ App, apis, Devtools }: FrameworkBootProps) => ReactNode;
+export declare const FrameworkBoot: ({ App, apis, Devtools, connect }: FrameworkBootProps) => ReactNode;
 
 export declare interface FrameworkBootProps {
     readonly App: ComponentType;
@@ -15,11 +15,13 @@ export declare interface FrameworkBootProps {
      *  (useFrameworkRuntimes etc.) resolve. PascalCase because it is a
      *  React component reference rendered as <Devtools/>. */
     readonly Devtools?: ComponentType;
+    /** Passed to `VoltroRuntimeProvider` — see its `connect` doc. */
+    readonly connect?: 'eager' | 'lazy';
 }
 
 export { MountedApi }
 
-export declare const VoltroRuntimeProvider: ({ apis, children, chrome }: VoltroRuntimeProviderProps) => ReactNode;
+export declare const VoltroRuntimeProvider: ({ apis, children, chrome, connect }: VoltroRuntimeProviderProps) => ReactNode;
 
 export declare interface VoltroRuntimeProviderProps {
     /** The apis to mount (name, group, descriptors, wsUrl, headers). */
@@ -33,6 +35,29 @@ export declare interface VoltroRuntimeProviderProps {
      *  unset. Gated behind the same post-mount flag as the rest of the
      *  chrome so it never trips a hydration mismatch. */
     readonly chrome?: ReactNode;
+    /**
+     * When each api connects.
+     *
+     *   'eager' (default) — every declared api opens its socket at mount, as it
+     *                       always has.
+     *   'lazy'            — an api connects on the FIRST hook that asks for it
+     *                       (`useFrameworkApi`, i.e. every data hook). A page
+     *                       that reads no data never opens a socket.
+     *
+     * `'lazy'` is not the default because it changes when a connection error
+     * surfaces, and an app that opens its socket for a side effect (a presence
+     * ping, an inspect stream) would notice. It is `web.api.connect` in
+     * `app.config.ts`.
+     *
+     * Why it exists, measured in a real browser against a `voltro start`:
+     * `interactive: 'full'` is the DEFAULT, and a pre-rendered documentation page
+     * with no subscription at all opened a WebSocket (`'none'` and `'islands'`
+     * opened none). And a connected socket keeps a dormancy-managed instance
+     * awake — `isIdleNow` is false while `connectedClients() > 0` — so a single
+     * open tab on a pricing page prevented scale-to-zero for as long as it stayed
+     * open.
+     */
+    readonly connect?: 'eager' | 'lazy';
 }
 
 export { }

package/dist/frameworkBoot.js

@@ -1,2 +1,2 @@
-import { n as e, t } from "./frameworkBoot-CnE9vzLQ.js";
+import { n as e, t } from "./frameworkBoot-BfJpdpZp.js";
 export { t as FrameworkBoot, e as VoltroRuntimeProvider };

package/dist/index.d.ts

@@ -760,6 +760,11 @@ export declare interface MountOptions {
      *  PascalCase because it is a React component reference rendered
      *  as <Devtools/>. */
     readonly Devtools?: ComponentType;
+    /** When each api connects — `'eager'` (default) or `'lazy'` (on the first
+     *  hook that asks for it). Set from `app.config.ts`'s `web.api.connect` by
+     *  the generated entry; see `VoltroRuntimeProvider`'s `connect` for the
+     *  measurements behind it. */
+    readonly connect?: 'eager' | 'lazy';
 }
 
 /** Options for an imperative navigation. `replace` swaps the current

package/dist/index.js

@@ -1,6 +1,6 @@
 import { t as e } from "./globalContext-AuflFFmy.js";
 import { AppClientsContext as t, useAppClient as n } from "./hooks.js";
-import { a as r, c as i, i as a, l as o, o as s, r as c, s as l, u } from "./frameworkBoot-CnE9vzLQ.js";
+import { a as r, c as i, i as a, l as o, o as s, r as c, s as l, u } from "./frameworkBoot-BfJpdpZp.js";
 import { a as d, c as f, i as p, l as m, o as h, u as g } from "./defaultFallbacks-SQ45vAhz.js";
 import { getIslandComponent as _, hydrateIslandsOnPage as v, island as y } from "./islands.js";
 import { c as b, d as x, f as S, g as C, l as w, m as T } from "./routerState-Cr6fTbka.js";