@voltro/web 0.8.0 → 0.9.0

package/CHANGELOG.md

@@ -39,6 +39,25 @@ _Changes staged for the next release accumulate here (rolled up from
 
 ---
 
+## [0.9.0] — 2026-07-21
+
+### ⚠ BREAKING
+
+- **@voltro/web, @voltro/cli** — A `renderMode: 'spa'` page whose route has an SSR layout chain now renders that LAYOUT on the server — an SSR shell — instead of rendering nothing server-side. This decouples layout SSR from page render mode: the layout (nav shell, sidebar, auth gate) is server-rendered for an instant first paint and SEO, while the page itself stays client-only. Concretely, on both `voltro dev` and `voltro start`, a spa page under a layout used to ship the empty client shell (`<div id="root"></div>`) and mount the whole tree — layout included — in the browser. Now the server renders the layout chain around an empty page slot (`<div data-voltro-page-slot>`), runs the LAYOUT loaders, and inlines their data + a `pageClientOnly` flag; the browser hydrates that shell and mounts the client-only page into the slot after hydration. The page's OWN loader still runs in the browser, exactly as before. A spa page with NO layout is unchanged (still a pure client mount); `static`/`ssr`/`isr` pages are unchanged. Why this is BREAKING: a layout component AND its `loader` now execute during the server render for spa routes. Layouts shared with any `static`/`ssr`/`isr` page already ran server-side (and `static` is the default), so they are unaffected — the only newly-server-rendered layout is one whose ENTIRE page subtree is `'spa'`. Such a layout must be SSR-safe: no unguarded `window`/`document` at render time or in its `loader`. The `voltro update` codemod (`0.9.0/01`) prints this review step, and only for projects that actually have both a spa page and a layout. Out of scope this release (follow-ups): build-time prerender of the spa layout shell (`voltro build` still skips spa pages, so `voltro start` renders the shell on demand rather than from a prerendered file), `defer()`/streaming inside a spa-shell layout (the shell is buffered), and Fast-Refresh coverage of the new shell path.
+
+### Added
+
+- **@voltro/protocol** — `jwtBearerStrategy` (and `extractBearerOrCookie`) accept an optional `cookieToToken` hook (`CookieTokenExtractor`) that transforms the request's cookie transport into the JWT to verify. It receives a `getCookie(name)` accessor (so a strategy can read sibling / chunked cookies) plus the configured cookie name. Applied to the cookie path only — the Bearer header stays a raw token — and defaulting to a verbatim read, so the raw-JWT cookie path for WorkOS / Kinde / Clerk / Auth0 / OIDC is byte-identical. `supabaseStrategy` supplies one to unwrap the `@supabase/ssr` session envelope. Additive: existing `jwtBearerStrategy` configs and 2-arg `extractBearerOrCookie` calls are unaffected.
+- **@voltro/cli** — `voltro doctor` now flags pages that are safe `renderMode:'spa'` candidates. A page is listed when ALL hold: it is a page file (not `layout`/`loading`/`error`/`not-found`), it exports no `loader`, its `renderMode` is `'ssr'` or unset/default (not already `'spa'`/`'static'`/`'isr'`), AND a `layout.tsx` sits somewhere in its directory chain (root, an ancestor, or the page's own dir). That last condition is load-bearing: only with a layout does switching to `'spa'` keep a server-rendered shell (the layout SSRs while the page body goes client-only) — a page with no layout would, as `'spa'`, ship no server HTML at all, so it is never flagged. The hint is ADVISORY and names the tradeoff: `renderMode:'spa'` skips the page's per-page SSR compile while its layout shell still renders server-side — adopt it for internal/authenticated pages whose body needs no SSR; keep `'ssr'` when the page content needs SEO or server first-paint. We deliberately ship NO codemod to auto-flip pages, because dropping a page body's server render is a per-page product decision, not a mechanically-safe transform. The scan reuses the framework's own page discovery (`walkPagesTree`), so it can't drift from what dev/build classify as a page. The full list is retrievable via `voltro doctor --json` (a new `spaCandidates` array); the human view caps at 10 with a "+N more" pointer.
+
+### Fixed
+
+- **@voltro/cli** — `voltro dev` no longer OOM-kills itself when many `renderMode:'ssr'` pages compile at once. The dev SSR renderer compiles each page (and every layout in its chain) on demand via Vite's `ssrLoadModule`, and that call was unbounded: two browser tabs on the same cold route, or a health-check sweep hitting hundreds of distinct routes, each started its OWN esbuild module tree with no dedupe and no concurrency cap, so the transient heaps added up and the process was killed (a downstream app with ~224 SSR pages reached >14 GB in seconds; `--max-old-space-size=8192` died after ~5 concurrent cold pages). The fix is a cold-compile gate (`coldCompileGate.ts`) around every `ssrLoadModule` in the dev SSR handler — the page, each layout/error/loading segment, and the shared `@voltro/web/ssr` helpers, so a sweep can't fan out on layouts either. It does two things: (1) DEDUPES concurrent requests for the same module — N tabs on one cold route trigger ONE compile they all await; (2) BOUNDS how many DISTINCT cold compiles run at once (default 4). A WARM module (already in Vite's graph) bypasses the gate entirely, so a hot app stays fully concurrent — the gate only tames the cold stampede, it never serializes warm serving. Verified: a concurrent sweep of 100 distinct cold routes runs exactly 4 concurrent esbuild trees under the default instead of 100, and 8 concurrent requests to one cold route compile the page once. The bound is overridable with `VOLTRO_DEV_SSR_COMPILE_CONCURRENCY` — drop it to `1`/`2` on a low-memory box, raise it on a beefy one. Default 4 balances memory against cold-sweep throughput (a lower value is safer but serializes first-paint of freshly-hit routes). Production `voltro start` is unaffected: it renders from a precompiled bundle and refuses to boot without one, so it never compiles on demand. The dev-like `voltro start` middleware FALLBACK (used only when `NODE_ENV!=='production'` and no bundle exists) shares the same `ssrLoadModule` path and now goes through the same gate. Covered by `coldCompileGate.test.ts` (dedupe, bound, warm bypass, failure-clears-and-retries, env parsing); the heavy end-to-end reproduction is a scratchpad (`scripts/measure-ssr-compile-oom.mjs`), not a CI gate.
+- **@voltro/cli** — `voltro update` (and `voltro update --codemods-only`) no longer aborts with `ELOOP: too many symbolic links` when the app tree contains a circular symlink. The codemod file scan built its ts-morph `Project` with `addSourceFilesAtPaths([...globs])`, whose underlying glob FOLLOWS symbolic links and applies the `!**/node_modules/**` negations only to the RESULTS — so a self-referential symlink anywhere under the app root (pnpm's package layout inside `node_modules`, or any stray symlinked scratch dir) made the walk descend forever and throw before any negation could apply. The scan now enumerates source files itself with `followSymbolicLinks: false` and prunes heavy directories (`node_modules`, `.git`, `dist`, `build`, `.framework`, `.turbo`, `.next`, `.cache`, `.output`, `.voltro-*`, …) at the traversal level rather than by post-filtering — the crawler never descends into them, and no symlink is followed, so a cycle put there by anything is harmless. App source a codemod rewrites is always real files on disk, so files reachable only through a symlink are deliberately not scanned (and never rewritten). A codemod's explicit `scope` still narrows the file set exactly as before.
+- **@voltro/plugin-auth-supabase** — `supabaseStrategy({ cookieName: 'sb-<ref>-auth-token' })` now reads `@supabase/ssr` session cookies. Those cookies do not hold a raw JWT — the SDK stores the GoTrue session as a JSON envelope, optionally `base64-`-encoded and split across `sb-<ref>-auth-token.0`, `.1`, … chunk cookies. The strategy previously handed that envelope straight to the JWT verifier, so every cookie-mode request failed with `malformed jwt` and fell back to anonymous (including `ctx.query` from a `type:'web'` loader, which forwards the browser cookie to the api). The strategy now unwraps the envelope — URL-decode, strip the `base64-` prefix and base64url-decode when present, concatenate chunks in order, then lift the inner `access_token` — before verification. The `Authorization: Bearer` path is unchanged (always a raw token). Hostile / malformed / oversized cookies resolve to anonymous (skip), never throw. Auth strategies belong on the `type:'api'` app, not the web app — the api verifies the forwarded cookie.
+
+---
+
 ## [0.8.0] — 2026-07-20
 
 ### ⚠ BREAKING

package/dist/index.d.ts

@@ -615,6 +615,8 @@ export declare class NotFoundError extends Error {
     constructor(detail?: string);
 }
 
+export declare const PAGE_SLOT_ATTR = "data-voltro-page-slot";
+
 export declare interface PageDescriptor<TLoaderData = unknown> {
     /** URL pattern, e.g. `/`, `/about`, `/users/[id]`, `/docs/[...slug]`. */
     readonly pattern: string;
@@ -705,6 +707,11 @@ export declare const pageRoute: (pattern: string, mod: Record<string, unknown>,
     readonly chain?: ReadonlyArray<RouteSegment>;
 }) => PageDescriptor;
 
+/** The empty page slot the SSR-layout-shell path renders at the leaf, on BOTH
+ *  the server (`renderPageToHtml` with `pageSlot`) and the client Router's
+ *  first render — identical markup, so hydration matches. */
+export declare const PageSlot: () => ReactNode;
+
 export declare const parseCookieHeader: (raw: string | undefined) => Record<string, string>;
 
 /** A caller may override any subtree, not the whole object — deep-partial per

package/dist/index.js

@@ -2,28 +2,28 @@ import { t as e } from "./globalContext-d4A-ugDg.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-C_d7E8Fj.js";
 import { a as d, c as f, i as p, l as m, o as h, s as g } from "./defaultFallbacks-CGs2z5qv.js";
-import { i as _, n as ee, r as te, t as ne } from "./mount-D3k8Ozdm.js";
-import { c as re, d as ie, h as ae, l as oe, p as se, u as ce } from "./routerState-ga64vk2B.js";
-import { A as le, B as ue, C as de, D as fe, E as pe, F as me, I as v, L as y, M as b, N as x, O as S, P as C, R as w, S as T, T as E, V as D, _ as O, a as k, b as A, c as j, d as M, f as N, g as P, h as F, i as I, j as L, k as R, l as z, m as he, n as ge, o as _e, p as ve, r as ye, s as be, t as xe, u as Se, v as Ce, w as we, x as Te, y as Ee, z as De } from "./serverContext-BW0GF8fv.js";
-import { Component as Oe, Suspense as ke, createElement as B, use as Ae, useCallback as je, useContext as Me, useSyncExternalStore as Ne } from "react";
+import { i as _, n as ee, r as te, t as ne } from "./mount-Gsn3ouYx.js";
+import { c as re, d as ie, h as ae, l as oe, p as se, u as ce } from "./routerState-DpUqogK8.js";
+import { A as le, B as ue, C as de, D as fe, E as pe, F as me, H as v, I as y, L as b, M as x, N as S, O as C, P as w, R as T, S as E, T as D, U as O, V as k, _ as A, a as j, b as M, c as N, d as P, f as F, g as I, h as L, i as R, j as z, k as he, l as ge, m as _e, n as ve, o as ye, p as be, r as xe, s as Se, t as Ce, u as we, v as Te, w as Ee, x as De, y as Oe, z as ke } from "./serverContext-COzippNt.js";
+import { Component as Ae, Suspense as je, createElement as B, use as Me, useCallback as Ne, useContext as Pe, useSyncExternalStore as Fe } from "react";
 import { Fragment as V, jsx as H, jsxs as U } from "react/jsx-runtime";
 export * from "@voltro/client";
 export * from "@voltro/ui";
 //#region src/await.tsx
-var Pe = ({ value: e, fallback: t, children: n, errorFallback: r }) => /* @__PURE__ */ H(ke, {
+var Ie = ({ value: e, fallback: t, children: n, errorFallback: r }) => /* @__PURE__ */ H(je, {
 	fallback: t,
-	children: /* @__PURE__ */ H(Ie, {
+	children: /* @__PURE__ */ H(Re, {
 		errorFallback: r,
-		children: /* @__PURE__ */ H(Fe, {
+		children: /* @__PURE__ */ H(Le, {
 			value: e,
 			errorFallback: r ?? null,
 			children: n
 		})
 	})
-}), W = ({ body: e }) => /* @__PURE__ */ H("script", { dangerouslySetInnerHTML: { __html: e } }), Fe = ({ value: e, errorFallback: t, children: n }) => {
-	let r = Ae(e), i = ce(e), a = ae(r);
+}), W = ({ body: e }) => /* @__PURE__ */ H("script", { dangerouslySetInnerHTML: { __html: e } }), Le = ({ value: e, errorFallback: t, children: n }) => {
+	let r = Me(e), i = ce(e), a = ae(r);
 	return a === void 0 ? /* @__PURE__ */ U(V, { children: [i === void 0 ? null : /* @__PURE__ */ H(W, { body: ie(i, r) }), n(r)] }) : /* @__PURE__ */ U(V, { children: [i === void 0 ? null : /* @__PURE__ */ H(W, { body: oe(i, a) }), t] });
-}, Ie = class extends Oe {
+}, Re = class extends Ae {
 	state = { error: void 0 };
 	static getDerivedStateFromError(e) {
 		return { error: e };
@@ -31,7 +31,7 @@ var Pe = ({ value: e, fallback: t, children: n, errorFallback: r }) => /* @__PUR
 	render() {
 		return this.state.error === void 0 ? this.props.children : this.props.errorFallback ?? null;
 	}
-}, G = ({ src: e }) => e, K = e("imageConfig", { loader: G }), Le = ({ loader: e, children: t }) => B(K.Provider, { value: { loader: e } }, t), q = [
+}, G = ({ src: e }) => e, K = e("imageConfig", { loader: G }), ze = ({ loader: e, children: t }) => B(K.Provider, { value: { loader: e } }, t), q = [
 	640,
 	750,
 	828,
@@ -40,7 +40,7 @@ var Pe = ({ value: e, fallback: t, children: n, errorFallback: r }) => /* @__PUR
 	1920,
 	2048,
 	3840
-], Re = (e, t, n, r) => {
+], Be = (e, t, n, r) => {
 	let i = n !== void 0 && !r ? Array.from(new Set(q.filter((e) => e <= n * 2).concat(n))).sort((e, t) => e - t) : [...q];
 	return {
 		srcSet: i.map((n) => `${e({
@@ -52,10 +52,10 @@ var Pe = ({ value: e, fallback: t, children: n, errorFallback: r }) => /* @__PUR
 			width: i[i.length - 1]
 		})
 	};
-}, ze = ({ src: e, alt: t, width: n, height: r, fill: i = !1, sizes: a, priority: o = !1, loader: s, placeholder: c = "empty", blurDataURL: l, style: u, ...d }) => {
-	let f = Me(K).loader, p = s ?? f;
+}, Ve = ({ src: e, alt: t, width: n, height: r, fill: i = !1, sizes: a, priority: o = !1, loader: s, placeholder: c = "empty", blurDataURL: l, style: u, ...d }) => {
+	let f = Pe(K).loader, p = s ?? f;
 	!i && (n === void 0 || r === void 0) && typeof console < "u" && console.warn(`<Image src="${e}"> needs both width and height (or fill) to reserve layout space and avoid CLS.`);
-	let { srcSet: m, fallback: h } = Re(p, e, n, i), g = c === "blur" && l ? {
+	let { srcSet: m, fallback: h } = Be(p, e, n, i), g = c === "blur" && l ? {
 		backgroundImage: `url(${l})`,
 		backgroundSize: "cover",
 		backgroundPosition: "center"
@@ -85,10 +85,10 @@ var Pe = ({ value: e, fallback: t, children: n, errorFallback: r }) => /* @__PUR
 		},
 		...d
 	});
-}, Be = ({ to: e, children: t, className: n }) => B("a", {
+}, He = ({ to: e, children: t, className: n }) => B("a", {
 	href: e,
 	className: n
-}, t), Ve = {
+}, t), Ue = {
 	position: "sticky",
 	top: 0,
 	zIndex: 10,
@@ -99,13 +99,13 @@ var Pe = ({ value: e, fallback: t, children: n, errorFallback: r }) => /* @__PUR
 	padding: "1rem 1.5rem",
 	borderBottom: "1px solid var(--voltro-blog-border, rgba(127,127,127,0.2))",
 	backdropFilter: "blur(8px)"
-}, He = {
+}, We = {
 	maxWidth: "48rem",
 	margin: "0 auto",
 	padding: "2rem 1.5rem",
 	width: "100%"
-}, Ue = (e) => {
-	let { brand: t, topNav: n, children: r, pathname: i, footer: a, breadcrumbs: o, headerRight: s } = e, c = e.Link ?? Be, l = B("nav", {
+}, Ge = (e) => {
+	let { brand: t, topNav: n, children: r, pathname: i, footer: a, breadcrumbs: o, headerRight: s } = e, c = e.Link ?? He, l = B("nav", {
 		className: "voltro-blog-nav",
 		style: {
 			display: "flex",
@@ -122,7 +122,7 @@ var Pe = ({ value: e, fallback: t, children: n, errorFallback: r }) => /* @__PUR
 		});
 	})), u = B("header", {
 		className: "voltro-blog-header",
-		style: Ve
+		style: Ue
 	}, B("div", { className: "voltro-blog-brand" }, t), s ? B("div", { style: {
 		display: "flex",
 		gap: "1rem",
@@ -150,7 +150,7 @@ var Pe = ({ value: e, fallback: t, children: n, errorFallback: r }) => /* @__PUR
 	})) : null;
 	return B("div", { className: "voltro-blog-layout" }, u, B("main", {
 		className: "voltro-blog-main",
-		style: He
+		style: We
 	}, d, r), a ? B("footer", {
 		className: "voltro-blog-footer",
 		style: {
@@ -160,7 +160,7 @@ var Pe = ({ value: e, fallback: t, children: n, errorFallback: r }) => /* @__PUR
 			borderTop: "1px solid var(--voltro-blog-border, rgba(127,127,127,0.2))"
 		}
 	}, a) : null);
-}, J = "voltro:theme", We = 31536e3, Ge = () => {
+}, J = "voltro:theme", Y = 31536e3, Ke = () => {
 	if (typeof document > "u") return "system";
 	try {
 		let e = document.cookie.match(/(?:^|;\s*)voltro:theme=([^;]*)/), t = e?.[1] === void 0 ? "" : decodeURIComponent(e[1]);
@@ -168,17 +168,17 @@ var Pe = ({ value: e, fallback: t, children: n, errorFallback: r }) => /* @__PUR
 	} catch {
 		return "system";
 	}
-}, Y = () => {
+}, qe = () => {
 	if (typeof window > "u" || !window.matchMedia) return !1;
 	try {
 		return window.matchMedia("(prefers-color-scheme: dark)").matches;
 	} catch {
 		return !1;
 	}
-}, X = (e) => e === "system" ? Y() ? "dark" : "light" : e, Z = 0, Q = /* @__PURE__ */ new Set(), $ = () => {
+}, X = (e) => e === "system" ? qe() ? "dark" : "light" : e, Z = 0, Q = /* @__PURE__ */ new Set(), $ = () => {
 	Z++;
 	for (let e of Q) e();
-}, Ke = (e) => {
+}, Je = (e) => {
 	Q.add(e);
 	let t, n = () => $();
 	if (typeof window < "u" && window.matchMedia) try {
@@ -190,21 +190,21 @@ var Pe = ({ value: e, fallback: t, children: n, errorFallback: r }) => /* @__PUR
 			t?.removeEventListener("change", n);
 		} catch {}
 	};
-}, qe = () => {
-	let e = Ge();
+}, Ye = () => {
+	let e = Ke();
 	return `${Z}:${e}:${X(e)}`;
-}, Je = () => "0:system:light", Ye = () => {
-	let [, e, t] = Ne(Ke, qe, Je).split(":");
+}, Xe = () => "0:system:light", Ze = () => {
+	let [, e, t] = Fe(Je, Ye, Xe).split(":");
 	return {
 		theme: e,
 		resolvedTheme: t,
-		setTheme: je((e) => {
+		setTheme: Ne((e) => {
 			if (typeof document < "u") try {
-				document.cookie = e === "system" ? `${J}=; path=/; max-age=0; SameSite=Lax` : `${J}=${e}; path=/; max-age=${We}; SameSite=Lax`, document.documentElement.classList.toggle("dark", X(e) === "dark");
+				document.cookie = e === "system" ? `${J}=; path=/; max-age=0; SameSite=Lax` : `${J}=${e}; path=/; max-age=${Y}; SameSite=Lax`, document.documentElement.classList.toggle("dark", X(e) === "dark");
 			} catch {}
 			$();
 		}, [])
 	};
-}, Xe = "framework-web";
+}, Qe = "framework-web";
 //#endregion
-export { t as AppClientsContext, Pe as Await, Ue as BlogLayout, p as FallbackStringsProvider, ze as Image, Le as ImageConfigProvider, _e as Link, be as LoaderCache, j as LoaderDataContext, i as NavigationIndicator, x as NotFoundError, z as PlainLink, o as ReconnectContext, C as RedirectError, Se as Router, M as RouterContext, xe as ServerRequestContext, ge as ServerRequestProvider, J as THEME_COOKIE, Xe as WEB_NAME, N as compileRoute, d as defaultFallbackStrings, re as defer, ve as externalUrl, he as findNotFound, c as formatPrintf, ee as getIslandComponent, De as getRouteSnapshot, g as getStatuses, te as hydrateIslandsOnPage, a as installBrowserConsoleBridge, r as installServerLogRelay, se as isDeferredLoaderResult, me as isNotFound, v as isRedirect, _ as island, F as lazyPageRoute, P as loaderCacheKey, O as matchRoute, ne as mount, y as notFound, Ce as pageRoute, ye as parseCookieHeader, G as passthroughImageLoader, Ee as preloadRouteModule, f as pushStatus, w as redirect, s as registerClientTrace, A as resolveAnchorNavigation, Te as resolveMeta, T as segmentLoaderKey, ue as setRouteSnapshot, de as sortRoutesByPriority, D as subscribeRouteSnapshot, m as subscribeStatuses, l as subscribeTraceErrors, n as useAppClient, we as useBlocker, h as useFallbackStrings, E as useLoaderData, pe as useLocation, fe as useNavigate, S as useParams, R as usePrefetch, u as useReconnect, I as useSearchParams, k as useServerRequest, le as useSetSearchParams, Ye as useTheme, L as withHash, b as withQuery };
+export { t as AppClientsContext, Ie as Await, Ge as BlogLayout, p as FallbackStringsProvider, Ve as Image, ze as ImageConfigProvider, ye as Link, Se as LoaderCache, N as LoaderDataContext, i as NavigationIndicator, me as NotFoundError, ge as PAGE_SLOT_ATTR, we as PageSlot, P as PlainLink, o as ReconnectContext, y as RedirectError, F as Router, be as RouterContext, Ce as ServerRequestContext, ve as ServerRequestProvider, J as THEME_COOKIE, Qe as WEB_NAME, _e as compileRoute, d as defaultFallbackStrings, re as defer, L as externalUrl, I as findNotFound, c as formatPrintf, ee as getIslandComponent, k as getRouteSnapshot, g as getStatuses, te as hydrateIslandsOnPage, a as installBrowserConsoleBridge, r as installServerLogRelay, se as isDeferredLoaderResult, b as isNotFound, T as isRedirect, _ as island, A as lazyPageRoute, Te as loaderCacheKey, Oe as matchRoute, ne as mount, ke as notFound, M as pageRoute, xe as parseCookieHeader, G as passthroughImageLoader, De as preloadRouteModule, f as pushStatus, ue as redirect, s as registerClientTrace, E as resolveAnchorNavigation, de as resolveMeta, Ee as segmentLoaderKey, v as setRouteSnapshot, D as sortRoutesByPriority, O as subscribeRouteSnapshot, m as subscribeStatuses, l as subscribeTraceErrors, n as useAppClient, pe as useBlocker, h as useFallbackStrings, fe as useLoaderData, C as useLocation, he as useNavigate, le as useParams, z as usePrefetch, u as useReconnect, R as useSearchParams, j as useServerRequest, x as useSetSearchParams, Ze as useTheme, S as withHash, w as withQuery };

package/dist/{mount-D3k8Ozdm.js → mount-Gsn3ouYx.js}

@@ -1,5 +1,5 @@
 import { t as e } from "./frameworkBoot-C_d7E8Fj.js";
-import { o as t, r as n, t as r } from "./routerState-ga64vk2B.js";
+import { o as t, r as n, t as r } from "./routerState-DpUqogK8.js";
 import { StrictMode as i, createElement as a } from "react";
 import { createRoot as o, hydrateRoot as s } from "react-dom/client";
 import { jsx as c } from "react/jsx-runtime";

package/dist/mount.js

@@ -1,2 +1,2 @@
-import { t as e } from "./mount-D3k8Ozdm.js";
+import { t as e } from "./mount-Gsn3ouYx.js";
 export { e as mount };

package/dist/{routerState-ga64vk2B.js → routerState-DpUqogK8.js}

@@ -65,6 +65,7 @@ var e = /* @__PURE__ */ RegExp("\\u2028", "g"), t = /* @__PURE__ */ RegExp("\\u2
 			...e.pageLoaderRan ? { page: !0 } : {},
 			...t.length > 0 ? { segments: t } : {}
 		},
+		...e.pageClientOnly ? { pageClientOnly: !0 } : {},
 		...n || r ? { deferred: {
 			...n ? { page: e.deferredPageIds } : {},
 			...r ? { segments: e.deferredSegmentIds } : {}
@@ -85,6 +86,7 @@ var e = /* @__PURE__ */ RegExp("\\u2028", "g"), t = /* @__PURE__ */ RegExp("\\u2
 		page: D(r.page, r.deferred?.page),
 		pageRan: r.ran?.page === !0,
 		segments: a.size > 0 ? a : T,
+		pageClientOnly: r.pageClientOnly === !0,
 		pathname: t
 	};
 }, D = (e, t) => {

package/dist/{serverContext-BW0GF8fv.js → serverContext-COzippNt.js}

@@ -1,6 +1,6 @@
 import { t as e } from "./globalContext-d4A-ugDg.js";
 import { c as t, n, t as r } from "./defaultFallbacks-CGs2z5qv.js";
-import { f as i, i as a } from "./routerState-ga64vk2B.js";
+import { f as i, i as a } from "./routerState-DpUqogK8.js";
 import { Component as o, useCallback as s, useContext as c, useEffect as l, useMemo as u, useRef as d, useState as f } from "react";
 import { jsx as p, jsxs as ee } from "react/jsx-runtime";
 //#region src/routeEventBus.ts
@@ -286,7 +286,7 @@ var m = {
 		}
 		return this.props.children;
 	}
-}, ve = ({ routes: e, notFounds: i = [], notFound: o = n, errorFallback: c = r }) => {
+}, B = "data-voltro-page-slot", ve = () => /* @__PURE__ */ p("div", { [B]: "" }), ye = ({ routes: e, notFounds: i = [], notFound: o = n, errorFallback: c = r }) => {
 	let [m, h] = f(() => window.location.pathname), [g, _] = f(() => window.location.pathname), [v, y] = f(() => window.location.search + window.location.hash), b = d(new le()), x = d(/* @__PURE__ */ new Map()), [C, w] = f(null), T = s((e, t) => (x.current.set(e, t), () => {
 		x.current.delete(e);
 	}), []), E = d(/* @__PURE__ */ new Map()), D = d(null), j = u(() => ie(e.map(re)), [e]);
@@ -351,7 +351,7 @@ var m = {
 		};
 		return document.addEventListener("click", e), () => document.removeEventListener("click", e);
 	}, [P]);
-	let I = u(() => O(j, m), [j, m]), R = d(/* @__PURE__ */ new Map()), [ve, ye] = f(0);
+	let I = u(() => O(j, m), [j, m]), R = d(/* @__PURE__ */ new Map()), [B, ye] = f(0);
 	l(() => {
 		let e = I?.route;
 		if (!e?.load || R.current.has(e.pattern)) return;
@@ -362,27 +362,27 @@ var m = {
 			t = !0;
 		};
 	}, [I?.route.load ? I.route.pattern : null]);
-	let B = u(() => {
+	let V = u(() => {
 		if (!I) return null;
 		let e = I.route;
 		if (!e.load) return e;
 		let t = R.current.get(e.pattern);
 		return t ? {
 			...e,
-			...Ee(t),
+			...De(t),
 			load: void 0
 		} : null;
-	}, [I, ve]), V = u(() => O(j, g), [j, g]), H = u(() => {
-		if (!V) return null;
-		let e = V.route;
+	}, [I, B]), H = u(() => O(j, g), [j, g]), U = u(() => {
+		if (!H) return null;
+		let e = H.route;
 		if (!e.load) return e;
 		let t = R.current.get(e.pattern);
 		return t ? {
 			...e,
-			...Ee(t),
+			...De(t),
 			load: void 0
 		} : null;
-	}, [V, ve]), Se = s((e) => {
+	}, [H, B]), W = s((e) => {
 		let t = new URL(e, window.location.origin), n = O(j, t.pathname);
 		if (!n) return;
 		let r = (e, r) => {
@@ -395,33 +395,37 @@ var m = {
 		n.route.loader && r(k(n.route.pattern, n.params), n.route.loader), n.route.chain?.forEach((e, t) => {
 			e.loader && r(ae(n.route.pattern, t, n.params), e.loader);
 		});
-	}, [j]), [U, W] = f({ status: "idle" }), G = d(void 0);
-	G.current === void 0 && (G.current = a());
-	let Ce = d(!1), [K, we] = f(() => ({
+	}, [j]), [G, K] = f({ status: "idle" }), q = d(void 0);
+	q.current === void 0 && (q.current = a());
+	let Se = d(!1), [Ce, we] = f(() => q.current?.pageClientOnly === !0 && q.current.pathname === m);
+	l(() => {
+		we(!1);
+	}, []);
+	let [J, Te] = f(() => ({
 		pathname: m,
-		data: me(G.current ?? null, m),
+		data: me(q.current ?? null, m),
 		chain: I?.route.chain
 	}));
 	l(() => {
 		let e = (e) => {
-			_(m), we((t) => t.pathname === m && he(t.data, e) ? t : {
+			_(m), Te((t) => t.pathname === m && he(t.data, e) ? t : {
 				pathname: m,
 				data: e,
 				chain: I?.route.chain
 			});
 		};
 		if (!I) {
-			W({ status: "idle" }), e(void 0);
+			K({ status: "idle" }), e(void 0);
 			return;
 		}
-		if (!B) {
-			W({
+		if (!V) {
+			K({
 				status: "pending",
 				key: k(I.route.pattern, I.params)
 			});
 			return;
 		}
-		let t = B, { params: n } = I, r = t.chain, i = (t.Pending ?? A(r, "Pending", r ? r.length - 1 : -1)) !== void 0, a = [];
+		let t = V, { params: n } = I, r = t.chain, i = (t.Pending ?? A(r, "Pending", r ? r.length - 1 : -1)) !== void 0, a = [];
 		if (t.loader) {
 			let e = t.loader;
 			a.push({
@@ -448,12 +452,12 @@ var m = {
 				});
 			}
 		}), a.length === 0) {
-			W({ status: "idle" }), e(void 0);
+			K({ status: "idle" }), e(void 0);
 			return;
 		}
-		let o = k(t.pattern, n), s = G.current;
-		if (s && !Ce.current && m === s.pathname) {
-			Ce.current = !0;
+		let o = k(t.pattern, n), s = q.current;
+		if (s && !Se.current && m === s.pathname) {
+			Se.current = !0;
 			for (let e of a) e.target === "page" ? s.pageRan && b.current.seed(e.cacheKey, s.page) : s.segments.has(e.target) && b.current.seed(e.cacheKey, s.segments.get(e.target));
 		}
 		let c = a.map((e) => ({
@@ -479,18 +483,18 @@ var m = {
 			};
 		}, u = l();
 		if (u) {
-			u.ok ? (W({
+			u.ok ? (K({
 				status: "success",
 				key: o,
 				data: u.data
-			}), e(u.data)) : (W({
+			}), e(u.data)) : (K({
 				status: "error",
 				key: o,
 				error: u.error
 			}), S(u.error) || e(void 0));
 			return;
 		}
-		W({
+		K({
 			status: "pending",
 			key: o
 		}), i && _(m);
@@ -498,11 +502,11 @@ var m = {
 		return Promise.all(f).then(() => {
 			if (d) return;
 			let t = l();
-			t && (t.ok ? (W({
+			t && (t.ok ? (K({
 				status: "success",
 				key: o,
 				data: t.data
-			}), e(t.data)) : (W({
+			}), e(t.data)) : (K({
 				status: "error",
 				key: o,
 				error: t.error
@@ -512,48 +516,48 @@ var m = {
 		};
 	}, [
 		I,
-		B,
+		V,
 		m
 	]);
-	let q = K.data?.page, J = g === m, Y = K.pathname === g, Te = Y ? K.data?.page : void 0, De = ge(), X = u(() => {
-		if (!V) return null;
-		let e = V.params.locale ?? De;
-		return se(H?.meta, V.params, q, e);
+	let Y = J.data?.page, X = g === m, Ee = J.pathname === g, Oe = Ee ? J.data?.page : void 0, ke = ge(), Z = u(() => {
+		if (!H) return null;
+		let e = H.params.locale ?? ke;
+		return se(U?.meta, H.params, Y, e);
 	}, [
-		V,
 		H,
-		q,
-		De
+		U,
+		Y,
+		ke
 	]);
-	l(() => _e(X), [X]);
-	let [Oe, Z] = f(""), Q = d(!1), [ke, Ae] = f(!1);
+	l(() => _e(Z), [Z]);
+	let [Q, Ae] = f(""), je = d(!1), [Me, Ne] = f(!1);
 	l(() => {
-		if (!Q.current) {
-			Q.current = !0, Ae(!0);
+		if (!je.current) {
+			je.current = !0, Ne(!0);
 			return;
 		}
-		let e = X?.title ?? (typeof document < "u" ? document.title : "");
-		Z(e && e.length > 0 ? e : g);
-	}, [g, X]), l(() => {
+		let e = Z?.title ?? (typeof document < "u" ? document.title : "");
+		Ae(e && e.length > 0 ? e : g);
+	}, [g, Z]), l(() => {
 		let e = D.current;
 		e && (D.current = null, de(() => window.scrollTo(e.x, e.y)));
 	}, [g]);
-	let je = u(() => ({
+	let Pe = u(() => ({
 		pathname: g,
 		search: v,
 		navigate: P,
-		params: V?.params ?? {},
-		prefetch: Se,
-		loaderData: q,
+		params: H?.params ?? {},
+		prefetch: W,
+		loaderData: Y,
 		registerBlocker: T,
 		blocked: C
 	}), [
 		g,
 		v,
 		P,
-		V,
-		Se,
-		q,
+		H,
+		W,
+		Y,
 		T,
 		C
 	]);
@@ -571,82 +575,83 @@ var m = {
 	}, []), l(() => {
 		te({
 			pathname: g,
-			params: V?.params ?? {},
-			loaderData: q
+			params: H?.params ?? {},
+			loaderData: Y
 		});
 	}, [
 		g,
-		V,
-		q
+		H,
+		Y
 	]), l(() => {
-		if (U.status === "pending") return t({
+		if (G.status === "pending") return t({
 			id: "voltro:router:loader",
 			kind: "loading",
 			label: "Loading…"
 		});
-	}, [U.status]), l(() => {
-		if (U.status === "error") return t({
+	}, [G.status]), l(() => {
+		if (G.status === "error") return t({
 			id: "voltro:router:loader-error",
 			kind: "error",
 			label: "Loader failed"
 		});
-	}, [U.status]), l(() => {
-		U.status === "error" && S(U.error) && P(U.error.location, { replace: !0 });
-	}, [U, P]);
-	let Me = () => {
+	}, [G.status]), l(() => {
+		G.status === "error" && S(G.error) && P(G.error.location, { replace: !0 });
+	}, [G, P]);
+	let Fe = () => {
 		let e = ce(i, g);
 		if (e) {
 			let { Component: t, chain: n } = e;
 			return xe(n, /* @__PURE__ */ p(t, {}), g, c);
 		}
 		return /* @__PURE__ */ p(o, {});
-	}, Ne = J && V && U.status === "error" ? U.error : void 0, $;
-	if (!V) $ = Me();
-	else if (ne(Ne)) $ = Me();
+	}, Ie = X && H && G.status === "error" ? G.error : void 0, $;
+	if (!H) $ = Fe();
+	else if (ne(Ie)) $ = Fe();
 	else {
-		let e = V.route.chain, t = e ? e.length - 1 : -1, n = H?.ErrorBoundary ?? A(e, "Error", t) ?? c, r;
-		if (J && U.status === "error" && !S(U.error)) r = /* @__PURE__ */ p(n, {
-			error: U.error,
+		let e = H.route.chain, t = e ? e.length - 1 : -1, n = U?.ErrorBoundary ?? A(e, "Error", t) ?? c, r;
+		if (Ce) r = /* @__PURE__ */ p(ve, {});
+		else if (X && G.status === "error" && !S(G.error)) r = /* @__PURE__ */ p(n, {
+			error: G.error,
 			reset: () => {
-				b.current.invalidate(V.route.pattern), h((e) => e), W({ status: "idle" });
+				b.current.invalidate(H.route.pattern), h((e) => e), K({ status: "idle" });
 			}
 		});
-		else if (J && U.status === "pending") {
-			let i = H?.Pending ?? A(e, "Pending", t);
+		else if (X && G.status === "pending") {
+			let i = U?.Pending ?? A(e, "Pending", t);
 			if (i) r = /* @__PURE__ */ p(i, {});
-			else if (H?.Component) {
-				let e = H.Component;
+			else if (U?.Component) {
+				let e = U.Component;
 				r = /* @__PURE__ */ p(z, {
 					resetKey: g,
 					Fallback: n,
 					children: /* @__PURE__ */ p(L.Provider, {
-						value: Te,
+						value: Oe,
 						children: /* @__PURE__ */ p(e, {})
 					})
 				});
 			} else r = null;
 		} else {
-			let e = H?.Component;
+			let e = U?.Component;
 			r = e ? /* @__PURE__ */ p(z, {
 				resetKey: g,
 				Fallback: n,
 				children: /* @__PURE__ */ p(L.Provider, {
-					value: Te,
+					value: Oe,
 					children: /* @__PURE__ */ p(e, {})
 				})
 			}) : null;
 		}
 		$ = xe(e, r, g, c, (t) => {
-			if (Y) return K.data?.segments[t];
+			if (Ee) return J.data?.segments[t];
 			let n = e?.[t]?.Layout;
-			return n !== void 0 && n === K.chain?.[t]?.Layout ? K.data?.segments[t] : void 0;
+			return n !== void 0 && n === J.chain?.[t]?.Layout ? J.data?.segments[t] : void 0;
 		});
 	}
 	return /* @__PURE__ */ ee(F.Provider, {
-		value: je,
-		children: [$, ke ? /* @__PURE__ */ p(be, { message: Oe }) : null]
+		value: Pe,
+		children: [$, Me ? /* @__PURE__ */ p(be, { message: Q }) : null]
 	});
-}, ye = {
+}, V = {
 	position: "absolute",
 	width: 1,
 	height: 1,
@@ -661,7 +666,7 @@ var m = {
 	role: "status",
 	"aria-live": "assertive",
 	"aria-atomic": "true",
-	style: ye,
+	style: V,
 	children: e
 }), xe = (e, t, n, r, i) => {
 	if (!e || e.length === 0) return t;
@@ -685,7 +690,7 @@ var m = {
 		}
 	}
 	return a;
-}, B = () => I().pathname, V = () => I().navigate, H = () => I().params, Se = () => c(L), U = () => I().prefetch, W = (e) => {
+}, H = () => I().pathname, U = () => I().navigate, W = () => I().params, G = () => c(L), K = () => I().prefetch, q = (e) => {
 	let { registerBlocker: t, blocked: n } = I(), r = d(Symbol("voltro:blocker")), i = d(e);
 	return i.current = e, l(() => {
 		let e = r.current;
@@ -699,22 +704,22 @@ var m = {
 		retry: n.retry,
 		reset: n.reset
 	} : { blocked: !1 };
-}, G = (e) => e instanceof URLSearchParams ? e : new URLSearchParams(e), Ce = () => {
+}, Se = (e) => e instanceof URLSearchParams ? e : new URLSearchParams(e), Ce = () => {
 	let { navigate: e } = I();
 	return s((t, n) => {
-		let r = new URLSearchParams(typeof window < "u" ? window.location.search : ""), i = G(typeof t == "function" ? t(r) : t).toString(), a = typeof window < "u" ? window.location.pathname : "/", o = i ? `${a}?${i}` : a;
+		let r = new URLSearchParams(typeof window < "u" ? window.location.search : ""), i = Se(typeof t == "function" ? t(r) : t).toString(), a = typeof window < "u" ? window.location.pathname : "/", o = i ? `${a}?${i}` : a;
 		e(o, {
 			replace: !n?.push,
 			...n?.scroll === void 0 ? {} : { scroll: n.scroll }
 		});
 	}, [e]);
-}, K = (e) => e, we = (e, t) => {
+}, we = (e) => e, J = (e, t) => {
 	let n = new URLSearchParams();
 	for (let [e, r] of Object.entries(t)) r !== void 0 && n.append(e, String(r));
 	let r = n.toString();
 	return r ? `${e}?${r}` : e;
-}, q = (e, t) => `${e}#${t.replace(/^#/, "")}`, J = (e) => /^([a-z][a-z0-9+.-]*:|\/\/|#)/i.test(e), Y = ({ to: e, children: t, onClick: n, prefetch: r = !1, replace: i = !1, onMouseEnter: a, onFocus: o, ...s }) => {
-	let c = V(), l = U(), u = J(e), d = (t) => {
+}, Te = (e, t) => `${e}#${t.replace(/^#/, "")}`, Y = (e) => /^([a-z][a-z0-9+.-]*:|\/\/|#)/i.test(e), X = ({ to: e, children: t, onClick: n, prefetch: r = !1, replace: i = !1, onMouseEnter: a, onFocus: o, ...s }) => {
+	let c = U(), l = K(), u = Y(e), d = (t) => {
 		u || t.metaKey || t.ctrlKey || t.shiftKey || t.altKey || t.button !== 0 || (t.preventDefault(), n?.(t), c(e, i ? { replace: i } : void 0));
 	}, f = (t) => {
 		r && !u && l(e), a?.(t);
@@ -729,10 +734,10 @@ var m = {
 		onFocus: ee,
 		children: t
 	});
-}, Te = (e) => Y({
+}, Ee = (e) => X({
 	...e,
 	to: e.to
-}), Ee = (e) => ({
+}), De = (e) => ({
 	Component: e.default,
 	meta: e.meta,
 	loader: e.loader,
@@ -740,30 +745,30 @@ var m = {
 	Pending: e.Pending,
 	renderMode: e.renderMode,
 	interactive: e.interactive
-}), De = (e, t, n = {}) => ({
+}), Oe = (e, t, n = {}) => ({
 	pattern: e,
-	...Ee(t),
+	...De(t),
 	chain: n.chain
-}), X = (e, t, n = {}) => ({
+}), ke = (e, t, n = {}) => ({
 	pattern: e,
 	load: t,
 	chain: n.chain
-}), Oe = async (e, t) => {
+}), Z = async (e, t) => {
 	let n = O(e.map(re), t)?.route.load;
 	if (n) try {
 		await n();
 	} catch {}
-}, Z = e("serverRequest", null), Q = () => c(Z), ke = () => {
-	let e = Q();
+}, Q = e("serverRequest", null), Ae = () => c(Q), je = () => {
+	let e = Ae();
 	if (e !== null) {
 		let t = e.url.indexOf("?");
 		return new URLSearchParams(t >= 0 ? e.url.slice(t + 1) : "");
 	}
 	return typeof window < "u" ? new URLSearchParams(window.location.search) : new URLSearchParams();
-}, Ae = ({ value: e, children: t }) => /* @__PURE__ */ p(Z.Provider, {
+}, Me = ({ value: e, children: t }) => /* @__PURE__ */ p(Q.Provider, {
 	value: e,
 	children: t
-}), je = (e) => {
+}), Ne = (e) => {
 	let t = {};
 	if (!e) return t;
 	for (let n of e.split(";")) {
@@ -781,4 +786,4 @@ var m = {
 	return t;
 };
 //#endregion
-export { Ce as A, te as B, ie as C, V as D, B as E, ne as F, S as I, b as L, we as M, v as N, H as O, y as P, x as R, ae as S, Se as T, _ as V, O as _, Q as a, ue as b, L as c, F as d, re as f, k as g, X as h, ke as i, q as j, U as k, Te as l, ce as m, Ae as n, Y as o, K as p, je as r, le as s, Z as t, ve as u, De as v, W as w, se as x, Oe as y, g as z };
+export { W as A, x as B, se as C, G as D, q as E, v as F, te as H, y as I, ne as L, Ce as M, Te as N, H as O, J as P, S as R, ue as S, ie as T, _ as U, g as V, ke as _, Ae as a, Oe as b, L as c, Ee as d, ye as f, ce as g, we as h, je as i, K as j, U as k, B as l, re as m, Me as n, X as o, F as p, Ne as r, le as s, Q as t, ve as u, k as v, ae as w, Z as x, O as y, b as z };

package/dist/ssr.d.ts

@@ -77,6 +77,13 @@ export declare interface InlinedRouterState {
         readonly page?: boolean;
         readonly segments?: ReadonlyArray<number>;
     };
+    /** True when the server rendered the layout chain but left the page leaf as
+     *  an EMPTY slot — the `renderMode:'spa'`-under-an-SSR-layout case. The
+     *  server ran only the layout loaders; the page is client-only. The client's
+     *  FIRST render must reproduce the identical empty slot so the layout chain
+     *  hydrates without a mismatch, then mount the real page after commit. Absent
+     *  (falsy) for every full-page SSR/ISR/static document. */
+    readonly pageClientOnly?: boolean;
     /** Deferred (streamed) loader fields: field name -> client-registry id, for
      *  the page loader and per chain index. The VALUES are not here — they
      *  arrive later, published by the settle `<script>` each `<Await>` boundary
@@ -319,6 +326,14 @@ export declare interface RenderPageOptions {
      *  catalog at meta-resolve time. Optional: when absent, page
      *  `meta(ctx)` callbacks see `ctx.locale = 'en'` as a safe default. */
     readonly locale?: string;
+    /** Render the LAYOUT CHAIN ONLY, with an empty page slot at the leaf
+     *  ({@link PageSlot}) instead of the page Component — the
+     *  `renderMode:'spa'`-under-an-SSR-layout case. The caller runs only the
+     *  layout loaders (not the page loader) and pairs this with a state script
+     *  carrying `pageClientOnly: true`, so the client reproduces the empty slot
+     *  on its first render and mounts the page after hydration. When set, the
+     *  descriptor need not carry a `Component`. */
+    readonly pageSlot?: boolean;
 }
 
 export declare interface RenderPageResult {
@@ -415,6 +430,12 @@ export declare interface RouterStateInput {
      *  `loaderData` (a loader may legitimately resolve to `undefined`/`null`,
      *  and the SSR paths default the field to `null` when there is no loader). */
     readonly pageLoaderRan: boolean;
+    /** Set by the SSR-layout-shell path (a `renderMode:'spa'` page under an SSR
+     *  layout chain): the server rendered the layouts + an empty page slot and
+     *  ran only the layout loaders. Tells the client to reproduce the empty slot
+     *  on its first render, then mount the page after hydration. Omit for every
+     *  full-page render. */
+    readonly pageClientOnly?: boolean | undefined;
     /** Page-loader deferred fields: name -> registry id. Produced by
      *  `prepareDeferredLoaderData` in the SSR pipeline; omit when nothing
      *  deferred (which is every non-streaming emitter). */

package/dist/ssr.js

@@ -1,21 +1,21 @@
-import { _ as e, a as t, g as n, m as r, n as i, p as a, s as o, t as s } from "./routerState-ga64vk2B.js";
-import { c, d as l, r as u, t as d, x as f } from "./serverContext-BW0GF8fv.js";
-import { createElement as p } from "react";
-import { renderToPipeableStream as m, renderToString as h } from "react-dom/server";
+import { _ as e, a as t, g as n, m as r, n as i, p as a, s as o, t as s } from "./routerState-DpUqogK8.js";
+import { C as c, c as l, p as u, r as d, t as f, u as p } from "./serverContext-COzippNt.js";
+import { createElement as m } from "react";
+import { renderToPipeableStream as h, renderToString as g } from "react-dom/server";
 //#region src/ssr.tsx
-var g = (e, t, n, r) => {
-	let i = p(c.Provider, { value: n }, p(e));
+var _ = (e, t, n, r) => {
+	let i = m(l.Provider, { value: n }, m(e));
 	if (!t) return i;
 	for (let e = t.length - 1; e >= 0; e--) {
 		let n = t[e];
 		if (n.Layout) {
 			let t = n.Layout;
-			i = p(c.Provider, { value: r(e) }, p(t, { children: i }));
+			i = m(l.Provider, { value: r(e) }, m(t, { children: i }));
 		}
 	}
 	return i;
-}, _ = (e) => {
-	let { descriptor: t, params: n, pathname: r, loaderData: i, segmentLoaderData: a, requestContext: o, outerWrap: s, locale: c } = e, u = f(t.meta, n, i, c), m = {
+}, v = (e) => {
+	let { descriptor: t, params: n, pathname: r, loaderData: i, segmentLoaderData: a, requestContext: o, outerWrap: s, locale: l, pageSlot: d } = e, h = c(t.meta, n, i, l), g = {
 		pathname: r,
 		search: "",
 		params: n,
@@ -26,23 +26,23 @@ var g = (e, t, n, r) => {
 		prefetch: () => {},
 		registerBlocker: () => () => {},
 		blocked: null
-	}, h = t.Component;
-	if (!h) throw Error(`SSR received a descriptor with no Component for "${r}". Lazy page routes are a client-only optimization and must not be used on the server.`);
-	let _ = p(l.Provider, { value: m }, g(h, t.chain, i, (e) => a?.[e]));
-	return o && (_ = p(d.Provider, { value: o }, _)), s && (_ = s(_)), {
-		tree: _,
-		meta: u
+	}, v = d ? p : t.Component;
+	if (!v) throw Error(`SSR received a descriptor with no Component for "${r}". Lazy page routes are a client-only optimization and must not be used on the server.`);
+	let y = m(u.Provider, { value: g }, _(v, t.chain, d ? void 0 : i, (e) => a?.[e]));
+	return o && (y = m(f.Provider, { value: o }, y)), s && (y = s(y)), {
+		tree: y,
+		meta: h
 	};
-}, v = (e) => {
-	let { tree: t, meta: n } = _(e);
+}, y = (e) => {
+	let { tree: t, meta: n } = v(e);
 	return {
-		html: h(t),
+		html: g(t),
 		meta: n
 	};
-}, y = (e) => {
-	let { tree: t, meta: n } = _(e);
+}, b = (e) => {
+	let { tree: t, meta: n } = v(e);
 	return {
-		stream: m(t, {
+		stream: h(t, {
 			...e.bootstrapModules ? { bootstrapModules: [...e.bootstrapModules] } : {},
 			...e.onShellReady ? { onShellReady: e.onShellReady } : {},
 			...e.onShellError ? { onShellError: e.onShellError } : {},
@@ -50,20 +50,20 @@ var g = (e, t, n, r) => {
 		}),
 		meta: n
 	};
-}, b = (e) => {
+}, x = (e) => {
 	if (!e) return "";
 	let t = [];
-	if (typeof e.title == "string" && t.push(`<title>${x(e.title)}</title>`), e.description && t.push(`<meta name="description" content="${S(e.description)}" />`), e.canonical && t.push(`<link rel="canonical" href="${S(e.canonical)}" />`), e.tags) for (let n of e.tags) {
-		let e = n.name ? `name="${S(n.name)}"` : n.property ? `property="${S(n.property)}"` : "";
-		e && t.push(`<meta ${e} content="${S(n.content)}" />`);
+	if (typeof e.title == "string" && t.push(`<title>${S(e.title)}</title>`), e.description && t.push(`<meta name="description" content="${C(e.description)}" />`), e.canonical && t.push(`<link rel="canonical" href="${C(e.canonical)}" />`), e.tags) for (let n of e.tags) {
+		let e = n.name ? `name="${C(n.name)}"` : n.property ? `property="${C(n.property)}"` : "";
+		e && t.push(`<meta ${e} content="${C(n.content)}" />`);
 	}
 	if (e.links) for (let n of e.links) {
 		let e = [
-			`rel="${S(n.rel)}"`,
-			`href="${S(n.href)}"`,
-			n.hreflang ? `hreflang="${S(n.hreflang)}"` : "",
-			n.type ? `type="${S(n.type)}"` : "",
-			n.title ? `title="${S(n.title)}"` : ""
+			`rel="${C(n.rel)}"`,
+			`href="${C(n.href)}"`,
+			n.hreflang ? `hreflang="${C(n.hreflang)}"` : "",
+			n.type ? `type="${C(n.type)}"` : "",
+			n.title ? `title="${C(n.title)}"` : ""
 		].filter(Boolean).join(" ");
 		t.push(`<link ${e} />`);
 	}
@@ -72,6 +72,6 @@ var g = (e, t, n, r) => {
 		t.push(`<script type="application/ld+json" data-voltro-page-jsonld>${e}<\/script>`);
 	}
 	return t.join("\n    ");
-}, x = (e) => e.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;"), S = (e) => e.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
+}, S = (e) => e.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;"), C = (e) => e.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
 //#endregion
-export { s as ROUTER_STATE_SCRIPT_ID, o as assertDeferralSupported, i as encodeRouterState, a as isDeferredLoaderResult, u as parseCookieHeader, r as prepareDeferredLoaderData, n as renderDeferredRegistryScript, b as renderMetaToHtml, v as renderPageToHtml, y as renderPageToStream, t as renderRouterStateScript, e as serialiseStateForInlining };
+export { s as ROUTER_STATE_SCRIPT_ID, o as assertDeferralSupported, i as encodeRouterState, a as isDeferredLoaderResult, d as parseCookieHeader, r as prepareDeferredLoaderData, n as renderDeferredRegistryScript, x as renderMetaToHtml, y as renderPageToHtml, b as renderPageToStream, t as renderRouterStateScript, e as serialiseStateForInlining };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/web",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "The Voltro web framework — file-based routing, render modes (SSR / SSG / islands), the page-export contract, data hooks, and the browser mount.",
   "keywords": [
     "voltro",
@@ -52,8 +52,8 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@voltro/client": "0.8.0",
-    "@voltro/ui": "0.8.0"
+    "@voltro/client": "0.9.0",
+    "@voltro/ui": "0.9.0"
   },
   "peerDependencies": {
     "@effect/platform": "^0.96.2",