@voltro/web 0.51.0 → 0.53.0

package/dist/ssr.d.ts

@@ -7,6 +7,7 @@ import { ProcedureTypeMap } from '@voltro/client';
 import { ReactNode } from 'react';
 import { seedPreloadedSubscription } from '@voltro/client';
 import { seedPreloadedSubscriptionFailure } from '@voltro/client';
+import { ServerRequestContextValue } from '@voltro/client';
 import { StoreSeed } from '@voltro/client';
 import { StoreSeedBag } from '@voltro/client';
 
@@ -93,12 +94,25 @@ export declare interface DeferralTarget {
      * Absent for every full-page render, where `renderMode` alone decides.
      */
     readonly layoutShell?: 'stream' | 'artefact' | undefined;
+    /**
+     * Partial prerendering: the page EXPORTED `ppr = true`. Makes `defer()` on
+     * `renderMode: 'isr'` legal — the cached SHELL renders the eager fields plus
+     * each `<Await>` fallback (credential-free, fail-closed), and the deferred
+     * HOLES run per request with the full request context, appended to the same
+     * response as registry settle scripts. The client reveals them through
+     * hydration — no React resume, no cached reveal scripts.
+     */
+    readonly ppr?: boolean;
 }
 
 /** Brand key on the object `defer()` returns. A single explicit container
  *  check — NOT a scan of arbitrary loader results for markers by shape. */
 declare const DEFERRED_RESULT_TAG: "__voltroDeferredLoaderResult";
 
+/** Stable registry id for one deferred field. `scope` is `'page'` or the
+ *  layout's chain index — the same index the router-state payload keys by. */
+export declare const deferredId: (scope: "page" | number, key: string) => string;
+
 /** What a loader returns when it defers part of its data. Opaque to user
  *  code: build it with {@link defer}, read it with `useLoaderData()`. */
 declare interface DeferredLoaderResult<TEager extends object = object, TDeferred extends Record<string, Promise<unknown>> = Record<string, Promise<unknown>>> {
@@ -111,6 +125,9 @@ declare interface DeferredLoaderResult<TEager extends object = object, TDeferred
     readonly deferred: TDeferred;
 }
 
+/** The body of the `<script>` `<Await>` emits when its promise resolves. */
+export declare const deferredSettleScript: (id: string, value: unknown) => string;
+
 /** Build the wire payload from what the server render was given. */
 export declare const encodeRouterState: (input: RouterStateInput) => InlinedRouterState;
 
@@ -372,6 +389,19 @@ declare interface PageDescriptor<TLoaderData = unknown> {
      *  set this to `'islands'` so only marked interactive zones
      *  hydrate; the rest stays pure static HTML. */
     readonly interactive?: InteractiveMode | undefined;
+    /**
+     * Intercepting route (modal-with-URL): when a SOFT navigation reaches this
+     * page FROM one of the `from` route patterns, the page renders as an
+     * OVERLAY above the still-mounted origin page instead of replacing it —
+     * URL changes, Back closes the overlay, a hard load of the same URL
+     * renders the page standalone. `from` is one or more route PATTERNS
+     * (`'/photos'`, `'/albums/[id]'`); a soft navigation from any other route
+     * renders standalone. Full-hydration pages only (`interactive: 'full'`) —
+     * islands/none pages have no client router to intercept with.
+     */
+    readonly intercept?: {
+        readonly from: string | ReadonlyArray<string>;
+    } | undefined;
 }
 
 declare interface PageMeta {
@@ -571,6 +601,11 @@ export declare interface RenderPageStreamOptions extends RenderPageOptions {
     /** Bootstrap `<script>` module URLs injected by React at the end of the
      *  shell — the client bundle that hydrates the streamed HTML. */
     readonly bootstrapModules?: ReadonlyArray<string>;
+    /** Per-request CSP nonce — React stamps it onto every script IT emits
+     *  (bootstrap modules, Suspense settle scripts). The shell's own tags are
+     *  stamped by the CLI's `stampScriptNonce`; the POLICY header is the
+     *  middleware's (plan 08 §7). */
+    readonly nonce?: string;
 }
 
 export declare interface RenderPageStreamResult {
@@ -726,16 +761,6 @@ export { seedPreloadedSubscriptionFailure }
  */
 export declare const serialiseStateForInlining: (state: unknown) => string;
 
-declare interface ServerRequestContextValue {
-    readonly cookies: Readonly<Record<string, string>>;
-    readonly headers: Readonly<Record<string, string>>;
-    /** Raw request URL as it came off the wire (path + query). Useful
-     *  for SSR pages that need to read `?q=…` style search params
-     *  without touching anything client-only. Empty string for build-
-     *  time SSG renders where there is no incoming request. */
-    readonly url: string;
-}
-
 /**
  * Run one request's render with a fresh seed bag; return what it collected
  * alongside the render's own result.

package/dist/ssr.js

@@ -1,31 +1,31 @@
-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-38JTbYPa.js";
-import { createElement as g } from "react";
-import { makePreloadSeedBag as _, makeStoreSeedBag as v, seedPreloadedSubscription as y, seedPreloadedSubscriptionFailure as b, setPreloadSeedResolver as x, setStoreSeedResolver as S } from "@voltro/client";
-import { renderToPipeableStream as C, renderToString as w } from "react-dom/server";
-import { AsyncLocalStorage as T } from "node:async_hooks";
+import { s as e } from "./defaultFallbacks-SQ45vAhz.js";
+import { _ as t, a as n, f as r, h as i, m as a, n as o, s, t as c, u as l, v as u } from "./routerState-Cr6fTbka.js";
+import { C as d, a as f, c as p, o as m, t as h, x as g } from "./serverContext-BwzZ6Q7d.js";
+import { createElement as _ } from "react";
+import { ServerRequestContext as v, makePreloadSeedBag as y, makeStoreSeedBag as b, seedPreloadedSubscription as x, seedPreloadedSubscriptionFailure as S, setPreloadSeedResolver as C, setStoreSeedResolver as w } from "@voltro/client";
+import { renderToPipeableStream as T, renderToString as E } from "react-dom/server";
+import { AsyncLocalStorage as D } from "node:async_hooks";
 //#region src/storeSeedScope.ts
-var E = new T();
-S(() => E.getStore()?.store ?? null), x(() => E.getStore()?.preload ?? null);
-var D = async (e) => {
+var O = new D();
+w(() => O.getStore()?.store ?? null), C(() => O.getStore()?.preload ?? null);
+var k = async (e) => {
 	let t = {
-		store: v(),
-		preload: _()
+		store: b(),
+		preload: y()
 	};
 	return {
-		result: await E.run(t, e),
+		result: await O.run(t, e),
 		storeSeeds: t.store.seeds,
 		preloadSeeds: t.preload.seeds
 	};
-}, O = () => {
+}, A = () => {
 	let e = {
-		store: v(),
-		preload: _()
+		store: b(),
+		preload: y()
 	};
-	return E.enterWith(e), e.store;
-}, k = () => E.getStore()?.store.seeds ?? null, A = () => E.getStore()?.preload.seeds ?? null, j = (e) => {
-	let t = k(), r = A(), i = e.storeSeeds !== void 0 || t === null || t.length === 0 ? e : {
+	return O.enterWith(e), e.store;
+}, j = () => O.getStore()?.store.seeds ?? null, M = () => O.getStore()?.preload.seeds ?? null, N = (e) => {
+	let t = j(), r = M(), i = e.storeSeeds !== void 0 || t === null || t.length === 0 ? e : {
 		...e,
 		storeSeeds: t
 	};
@@ -33,19 +33,19 @@ var D = async (e) => {
 		...i,
 		preloadSeeds: r
 	});
-}, M = (e, t, n, r, i) => {
-	let a = g(u.Provider, { value: i ? n : f }, g(e));
+}, P = (e, t, n, r, i) => {
+	let a = _(f.Provider, { value: i ? n : m }, _(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 = g(u.Provider, { value: n.loader === void 0 ? f : r(e) }, g(t, { children: a }));
+			a = _(f.Provider, { value: n.loader === void 0 ? m : r(e) }, _(t, { children: a }));
 		}
 	}
 	return a;
-}, N = (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 = {
+}, F = (t) => {
+	let { descriptor: n, params: r, pathname: i, search: a, loaderData: o, segmentLoaderData: s, requestContext: c, outerWrap: l, locale: u, pageSlot: f } = t, m = d(n.meta, r, o, u), h = {
 		pathname: i,
 		search: a ?? "",
 		params: r,
@@ -56,47 +56,48 @@ var D = async (e) => {
 		prefetch: () => {},
 		registerBlocker: () => () => {},
 		blocked: null
-	}, y = p ? d : n.Component;
+	}, y = f ? p : 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, M(y, n.chain, p ? void 0 : o, (e) => s?.[e], !p && n.loader !== void 0));
-	return b = g(e, {
+	let b = g(h, P(y, n.chain, f ? void 0 : o, (e) => s?.[e], !f && n.loader !== void 0));
+	return b = _(e, {
 		chrome: null,
 		children: b
-	}), c && (b = g(m.Provider, { value: c }, b)), u && (b = u(b)), {
+	}), c && (b = _(v.Provider, { value: c }, b)), l && (b = l(b)), {
 		tree: b,
-		meta: _
+		meta: m
 	};
-}, P = (e) => {
-	let { tree: t, meta: n } = N(e);
+}, I = (e) => {
+	let { tree: t, meta: n } = F(e);
 	return {
-		html: w(t),
+		html: E(t),
 		meta: n
 	};
-}, F = (e) => {
-	let { tree: t, meta: n } = N(e);
+}, L = (e) => {
+	let { tree: t, meta: n } = F(e);
 	return {
-		stream: C(t, {
+		stream: T(t, {
 			...e.bootstrapModules ? { bootstrapModules: [...e.bootstrapModules] } : {},
+			...e.nonce === void 0 ? {} : { nonce: e.nonce },
 			...e.onShellReady ? { onShellReady: e.onShellReady } : {},
 			...e.onShellError ? { onShellError: e.onShellError } : {},
 			...e.onAllReady ? { onAllReady: e.onAllReady } : {}
 		}),
 		meta: n
 	};
-}, I = (e) => {
+}, R = (e) => {
 	if (!e) return "";
 	let t = [];
-	if (typeof e.title == "string" && t.push(`<title>${L(e.title)}</title>`), e.description && t.push(`<meta name="description" content="${R(e.description)}" />`), e.noIndex && t.push("<meta name=\"robots\" content=\"noindex, nofollow\" />"), e.canonical && t.push(`<link rel="canonical" href="${R(e.canonical)}" />`), e.tags) for (let n of e.tags) {
-		let e = n.name ? `name="${R(n.name)}"` : n.property ? `property="${R(n.property)}"` : "";
-		e && t.push(`<meta ${e} content="${R(n.content)}" />`);
+	if (typeof e.title == "string" && t.push(`<title>${z(e.title)}</title>`), e.description && t.push(`<meta name="description" content="${B(e.description)}" />`), e.noIndex && t.push("<meta name=\"robots\" content=\"noindex, nofollow\" />"), e.canonical && t.push(`<link rel="canonical" href="${B(e.canonical)}" />`), e.tags) for (let n of e.tags) {
+		let e = n.name ? `name="${B(n.name)}"` : n.property ? `property="${B(n.property)}"` : "";
+		e && t.push(`<meta ${e} content="${B(n.content)}" />`);
 	}
 	if (e.links) for (let n of e.links) {
 		let e = [
-			`rel="${R(n.rel)}"`,
-			`href="${R(n.href)}"`,
-			n.hreflang ? `hreflang="${R(n.hreflang)}"` : "",
-			n.type ? `type="${R(n.type)}"` : "",
-			n.title ? `title="${R(n.title)}"` : ""
+			`rel="${B(n.rel)}"`,
+			`href="${B(n.href)}"`,
+			n.hreflang ? `hreflang="${B(n.hreflang)}"` : "",
+			n.type ? `type="${B(n.type)}"` : "",
+			n.title ? `title="${B(n.title)}"` : ""
 		].filter(Boolean).join(" ");
 		t.push(`<link ${e} />`);
 	}
@@ -105,6 +106,6 @@ var D = async (e) => {
 		t.push(`<script type="application/ld+json" data-voltro-page-jsonld>${e}<\/script>`);
 	}
 	return t.join("\n    ");
-}, L = (e) => e.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;"), R = (e) => e.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
+}, z = (e) => e.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;"), B = (e) => e.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
 //#endregion
-export { c as ROUTER_STATE_SCRIPT_ID, s as assertDeferralSupported, O as beginStoreSeeds, A as currentPreloadSeeds, k as currentStoreSeeds, a as encodeRouterState, o as isDeferredLoaderResult, p as parseCookieHeader, i as prepareDeferredLoaderData, r as renderDeferredRegistryScript, I as renderMetaToHtml, P as renderPageToHtml, F as renderPageToStream, j as renderRouterStateScript, y as seedPreloadedSubscription, b as seedPreloadedSubscriptionFailure, t as serialiseStateForInlining, D as withStoreSeeds };
+export { c as ROUTER_STATE_SCRIPT_ID, s as assertDeferralSupported, A as beginStoreSeeds, M as currentPreloadSeeds, j as currentStoreSeeds, l as deferredId, r as deferredSettleScript, o as encodeRouterState, a as isDeferredLoaderResult, h as parseCookieHeader, i as prepareDeferredLoaderData, t as renderDeferredRegistryScript, R as renderMetaToHtml, I as renderPageToHtml, L as renderPageToStream, N as renderRouterStateScript, x as seedPreloadedSubscription, S as seedPreloadedSubscriptionFailure, u as serialiseStateForInlining, k as withStoreSeeds };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/web",
-  "version": "0.51.0",
+  "version": "0.53.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",
@@ -48,7 +48,12 @@
       "import": "./dist/middleware.js",
       "default": "./dist/middleware.js"
     },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./islands": {
+      "types": "./dist/islands.d.ts",
+      "import": "./dist/islands.js",
+      "default": "./dist/islands.js"
+    }
   },
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -58,8 +63,8 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@voltro/client": "0.51.0",
-    "@voltro/ui": "0.51.0"
+    "@voltro/client": "0.53.0",
+    "@voltro/ui": "0.53.0"
   },
   "peerDependencies": {
     "@effect/platform": "^0.97.0",

package/dist/globalContext-d4A-ugDg.js

@@ -1,10 +0,0 @@
-import { createContext as e } from "react";
-//#region src/globalContext.ts
-var t = (t, n) => {
-	let r = globalThis, i = Symbol.for(`@voltro/web/context:${t}`), a = r[i];
-	if (a) return a;
-	let o = e(n);
-	return r[i] = o, o;
-};
-//#endregion
-export { t };

package/dist/mount-nudb4UCl.js

@@ -1,81 +0,0 @@
-import { t as e } from "./frameworkBoot-CV_o2tIk.js";
-import { o as t, r as n, t as r } from "./routerState-DAT472IC.js";
-import { StrictMode as i, createElement as a } from "react";
-import { createRoot as o, hydrateRoot as s } from "react-dom/client";
-import { applyPreloadSeeds as c, applyStoreSeeds as l } from "@voltro/client";
-import { jsx as u } from "react/jsx-runtime";
-//#region src/islands.tsx
-var d = /* @__PURE__ */ new Map(), f = (e, t) => {
-	d.set(t.name, e);
-	let n = t.hydrate ?? "visible", r = (r) => a("div", {
-		"data-voltro-island": "",
-		"data-island-name": t.name,
-		"data-island-hydrate": n,
-		"data-island-props": m(r)
-	}, a(e, r));
-	return r.displayName = `Island(${t.name})`, r;
-}, p = (e) => d.get(e), m = (e) => JSON.stringify(e ?? {}).replace(/</g, "\\u003c"), h = (e) => {
-	if (!e) return {};
-	try {
-		return JSON.parse(e);
-	} catch {
-		return {};
-	}
-}, g = () => {
-	let e = document.querySelectorAll("[data-voltro-island]:not([data-voltro-hydrated])");
-	for (let t of e) {
-		let e = t.dataset.islandName ?? "", n = d.get(e);
-		if (!n) {
-			console.warn(`[voltro] island "${e}" referenced in DOM but not registered. Did the island file get imported in this bundle?`);
-			continue;
-		}
-		let r = h(t.dataset.islandProps ?? null), i = t.dataset.islandHydrate ?? "visible";
-		t.setAttribute("data-voltro-hydrated", "pending");
-		let o = () => {
-			t.getAttribute("data-voltro-hydrated") !== "done" && (t.setAttribute("data-voltro-hydrated", "done"), s(t, a(n, r)));
-		};
-		if (i === "load") o();
-		else if (i === "idle") {
-			let e = globalThis.requestIdleCallback;
-			e ? e(o) : setTimeout(o, 0);
-		} else if (i === "visible") {
-			let e = new IntersectionObserver((t) => {
-				t.some((e) => e.isIntersecting) && (e.disconnect(), o());
-			}, { rootMargin: "64px" });
-			e.observe(t);
-		} else if (i === "interaction") {
-			let e = () => {
-				t.removeEventListener("pointerdown", e), t.removeEventListener("keydown", e), o();
-			};
-			t.addEventListener("pointerdown", e, { passive: !0 }), t.addEventListener("keydown", e);
-		}
-	}
-}, _ = () => !1, v = "__voltroIslandsBundleNoticeShown", y = (e) => {
-	if (!e) return;
-	let t = globalThis;
-	t[v] !== !0 && (t[v] = !0, console.info("[voltro] islands mode: hydration is scoped to this page's islands, but the JS payload is NOT reduced — the full app bundle is still downloaded and evaluated. Islands buy CPU, not bytes, today. See the \"Render modes\" docs page."));
-}, b = (e) => `${window.location.protocol === "https:" ? "wss:" : "ws:"}//${window.location.host}/ws/${e}`, x = (a, d) => {
-	let f = document.getElementById(d.rootId ?? "root");
-	if (!f) throw Error(`@voltro/web: no #${d.rootId ?? "root"} element in the document`);
-	let p = Object.entries(d.apis).map(([e, t]) => ({
-		name: e,
-		group: t.group,
-		descriptors: t.descriptors ?? {},
-		wsUrl: t.wsUrl ?? b(e),
-		headers: t.headers
-	})), m = document.getElementById(r), h = n(m?.textContent, window.location.pathname), v = h !== null && f.children.length > 0, x = document.querySelector("meta[name=\"voltro-interactive\"]")?.getAttribute("content") ?? "full";
-	if (x === "none") return;
-	if (x === "islands") {
-		y(_()), g();
-		return;
-	}
-	v && t(h), l(h?.storeSeeds), c(h?.preloadSeeds);
-	let S = /* @__PURE__ */ u(i, { children: /* @__PURE__ */ u(e, {
-		App: a,
-		apis: p,
-		...d.Devtools ? { Devtools: d.Devtools } : {}
-	}) });
-	v ? s(f, S) : o(f).render(S);
-};
-//#endregion
-export { f as a, g as i, y as n, p as r, x as t };