@voltro/web 0.29.0 → 0.30.1

package/dist/ssr.d.ts

@@ -423,8 +423,22 @@ export declare interface RenderPageOptions {
     /** URL pattern's resolved params. `{}` for static, no-param routes. */
     readonly params: Readonly<Record<string, string>>;
     /** Pathname this render resolves under. Used by `useLocation()` on
-     *  the server side. */
+     *  the server side. Query-free by contract — see {@link RenderPageOptions.search}. */
     readonly pathname: string;
+    /**
+     * The request's query string, INCLUDING the leading `?` (or `''`).
+     *
+     * The server used to hardcode `''` here, on the grounds that the client reads
+     * `window.location.search` on hydration. That is true, and it is exactly why
+     * discarding it was a defect: the client reading the REAL value is what turns
+     * a dropped query string into a hydration mismatch, on every page whose markup
+     * depends on `?tab=…`. Reported by a consumer against a sidebar's active-item
+     * highlight on `/teams/:id?tab=…`.
+     *
+     * Omitted on the STATIC prerender, where there is genuinely no request and one
+     * artefact serves every visitor — `''` is the truthful value there.
+     */
+    readonly search?: string;
     /** Page (leaf) loader data — pre-resolved by the caller. The build /
      *  SSR pipeline runs the descriptor's `loader` (if any) and passes the
      *  result here; reachable via `useLoaderData()` inside the page. */

package/dist/ssr.js

@@ -1,77 +1,81 @@
-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-DAT472IC.js";
-import { T as c, c as l, d as u, h as d, l as f, r as p, t as m } from "./serverContext-B1Pivair.js";
-import { createElement as h } from "react";
-import { makePreloadSeedBag as g, makeStoreSeedBag as _, seedPreloadedSubscription as v, setPreloadSeedResolver as y, setStoreSeedResolver as b } from "@voltro/client";
-import { renderToPipeableStream as x, renderToString as S } from "react-dom/server";
-import { AsyncLocalStorage as C } from "node:async_hooks";
+import { s as e } from "./defaultFallbacks-B4Ak-R6R.js";
+import { _ as t, a as n, g as r, m as i, n as a, p as o, s, t as c } from "./routerState-DAT472IC.js";
+import { E as l, c as u, d, l as f, r as p, t as m, w as h } from "./serverContext-3i6Dr4ev.js";
+import { createElement as g } from "react";
+import { makePreloadSeedBag as _, makeStoreSeedBag as v, seedPreloadedSubscription as y, setPreloadSeedResolver as b, setStoreSeedResolver as x } from "@voltro/client";
+import { renderToPipeableStream as S, renderToString as C } from "react-dom/server";
+import { AsyncLocalStorage as w } from "node:async_hooks";
 //#region src/storeSeedScope.ts
-var w = new C();
-b(() => w.getStore()?.store ?? null), y(() => w.getStore()?.preload ?? null);
-var T = async (e) => {
+var T = new w();
+x(() => T.getStore()?.store ?? null), b(() => T.getStore()?.preload ?? null);
+var E = async (e) => {
 	let t = {
-		store: _(),
-		preload: g()
+		store: v(),
+		preload: _()
 	};
 	return {
-		result: await w.run(t, e),
+		result: await T.run(t, e),
 		storeSeeds: t.store.seeds,
 		preloadSeeds: t.preload.seeds
 	};
-}, E = () => {
+}, D = () => {
 	let e = {
-		store: _(),
-		preload: g()
+		store: v(),
+		preload: _()
 	};
-	return w.enterWith(e), e.store;
-}, D = () => w.getStore()?.store.seeds ?? null, O = () => w.getStore()?.preload.seeds ?? null, k = (e) => {
-	let n = D(), r = O(), i = e.storeSeeds !== void 0 || n === null || n.length === 0 ? e : {
+	return T.enterWith(e), e.store;
+}, O = () => T.getStore()?.store.seeds ?? null, k = () => T.getStore()?.preload.seeds ?? null, A = (e) => {
+	let t = O(), r = k(), i = e.storeSeeds !== void 0 || t === null || t.length === 0 ? e : {
 		...e,
-		storeSeeds: n
+		storeSeeds: t
 	};
-	return t(e.preloadSeeds !== void 0 || r === null || r.length === 0 ? i : {
+	return n(e.preloadSeeds !== void 0 || r === null || r.length === 0 ? i : {
 		...i,
 		preloadSeeds: r
 	});
-}, A = (e, t, n, r, i) => {
-	let a = h(l.Provider, { value: i ? n : f }, h(e));
+}, j = (e, t, n, r, i) => {
+	let a = g(u.Provider, { value: i ? n : f }, g(e));
 	if (!t) return a;
 	for (let e = t.length - 1; e >= 0; e--) {
 		let n = t[e];
 		if (n.Layout) {
 			let t = n.Layout;
-			a = h(l.Provider, { value: n.loader === void 0 ? f : r(e) }, h(t, { children: a }));
+			a = g(u.Provider, { value: n.loader === void 0 ? f : r(e) }, g(t, { children: a }));
 		}
 	}
 	return a;
-}, j = (e) => {
-	let { descriptor: t, params: n, pathname: r, loaderData: i, segmentLoaderData: a, requestContext: o, outerWrap: s, locale: l, pageSlot: f } = e, p = c(t.meta, n, i, l), g = {
-		pathname: r,
-		search: "",
-		params: n,
-		loaderData: i,
+}, M = (t) => {
+	let { descriptor: n, params: r, pathname: i, search: a, loaderData: o, segmentLoaderData: s, requestContext: c, outerWrap: u, locale: f, pageSlot: p } = t, _ = l(n.meta, r, o, f), v = {
+		pathname: i,
+		search: a ?? "",
+		params: r,
+		loaderData: o,
 		navigate: () => {
 			throw Error("navigate() is not supported during server-side rendering. Trigger navigations on the client only.");
 		},
 		prefetch: () => {},
 		registerBlocker: () => () => {},
 		blocked: null
-	}, _ = f ? u : t.Component;
-	if (!_) 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 v = h(d.Provider, { value: g }, A(_, t.chain, f ? void 0 : i, (e) => a?.[e], !f && t.loader !== void 0));
-	return o && (v = h(m.Provider, { value: o }, v)), s && (v = s(v)), {
-		tree: v,
-		meta: p
+	}, y = p ? d : n.Component;
+	if (!y) throw Error(`SSR received a descriptor with no Component for "${i}". Lazy page routes are a client-only optimization and must not be used on the server.`);
+	let b = h(v, j(y, n.chain, p ? void 0 : o, (e) => s?.[e], !p && n.loader !== void 0));
+	return b = g(e, {
+		chrome: null,
+		children: b
+	}), c && (b = g(m.Provider, { value: c }, b)), u && (b = u(b)), {
+		tree: b,
+		meta: _
 	};
-}, M = (e) => {
-	let { tree: t, meta: n } = j(e);
+}, N = (e) => {
+	let { tree: t, meta: n } = M(e);
 	return {
-		html: S(t),
+		html: C(t),
 		meta: n
 	};
-}, N = (e) => {
-	let { tree: t, meta: n } = j(e);
+}, P = (e) => {
+	let { tree: t, meta: n } = M(e);
 	return {
-		stream: x(t, {
+		stream: S(t, {
 			...e.bootstrapModules ? { bootstrapModules: [...e.bootstrapModules] } : {},
 			...e.onShellReady ? { onShellReady: e.onShellReady } : {},
 			...e.onShellError ? { onShellError: e.onShellError } : {},
@@ -79,20 +83,20 @@ var T = async (e) => {
 		}),
 		meta: n
 	};
-}, P = (e) => {
+}, F = (e) => {
 	if (!e) return "";
 	let t = [];
-	if (typeof e.title == "string" && t.push(`<title>${F(e.title)}</title>`), e.description && t.push(`<meta name="description" content="${I(e.description)}" />`), e.noIndex && t.push("<meta name=\"robots\" content=\"noindex, nofollow\" />"), e.canonical && t.push(`<link rel="canonical" href="${I(e.canonical)}" />`), e.tags) for (let n of e.tags) {
-		let e = n.name ? `name="${I(n.name)}"` : n.property ? `property="${I(n.property)}"` : "";
-		e && t.push(`<meta ${e} content="${I(n.content)}" />`);
+	if (typeof e.title == "string" && t.push(`<title>${I(e.title)}</title>`), e.description && t.push(`<meta name="description" content="${L(e.description)}" />`), e.noIndex && t.push("<meta name=\"robots\" content=\"noindex, nofollow\" />"), e.canonical && t.push(`<link rel="canonical" href="${L(e.canonical)}" />`), e.tags) for (let n of e.tags) {
+		let e = n.name ? `name="${L(n.name)}"` : n.property ? `property="${L(n.property)}"` : "";
+		e && t.push(`<meta ${e} content="${L(n.content)}" />`);
 	}
 	if (e.links) for (let n of e.links) {
 		let e = [
-			`rel="${I(n.rel)}"`,
-			`href="${I(n.href)}"`,
-			n.hreflang ? `hreflang="${I(n.hreflang)}"` : "",
-			n.type ? `type="${I(n.type)}"` : "",
-			n.title ? `title="${I(n.title)}"` : ""
+			`rel="${L(n.rel)}"`,
+			`href="${L(n.href)}"`,
+			n.hreflang ? `hreflang="${L(n.hreflang)}"` : "",
+			n.type ? `type="${L(n.type)}"` : "",
+			n.title ? `title="${L(n.title)}"` : ""
 		].filter(Boolean).join(" ");
 		t.push(`<link ${e} />`);
 	}
@@ -101,6 +105,6 @@ var T = async (e) => {
 		t.push(`<script type="application/ld+json" data-voltro-page-jsonld>${e}<\/script>`);
 	}
 	return t.join("\n    ");
-}, F = (e) => e.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;"), I = (e) => e.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
+}, I = (e) => e.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;"), L = (e) => e.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
 //#endregion
-export { s as ROUTER_STATE_SCRIPT_ID, o as assertDeferralSupported, E as beginStoreSeeds, O as currentPreloadSeeds, D as currentStoreSeeds, i as encodeRouterState, a as isDeferredLoaderResult, p as parseCookieHeader, r as prepareDeferredLoaderData, n as renderDeferredRegistryScript, P as renderMetaToHtml, M as renderPageToHtml, N as renderPageToStream, k as renderRouterStateScript, v as seedPreloadedSubscription, e as serialiseStateForInlining, T as withStoreSeeds };
+export { c as ROUTER_STATE_SCRIPT_ID, s as assertDeferralSupported, D as beginStoreSeeds, k as currentPreloadSeeds, O as currentStoreSeeds, a as encodeRouterState, o as isDeferredLoaderResult, p as parseCookieHeader, i as prepareDeferredLoaderData, r as renderDeferredRegistryScript, F as renderMetaToHtml, N as renderPageToHtml, P as renderPageToStream, A as renderRouterStateScript, y as seedPreloadedSubscription, t as serialiseStateForInlining, E as withStoreSeeds };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/web",
-  "version": "0.29.0",
+  "version": "0.30.1",
   "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.29.0",
-    "@voltro/ui": "0.29.0"
+    "@voltro/client": "0.30.1",
+    "@voltro/ui": "0.30.1"
   },
   "peerDependencies": {
     "@effect/platform": "^0.97.0",