@voltro/web 0.28.0 → 0.30.0

package/dist/ssr.d.ts

@@ -1,6 +1,8 @@
 import { ComponentType } from 'react';
 import { PipeableStream } from 'react-dom/server';
+import { PreloadSeed } from '@voltro/client';
 import { ReactNode } from 'react';
+import { seedPreloadedSubscription } from '@voltro/client';
 import { StoreSeed } from '@voltro/client';
 import { StoreSeedBag } from '@voltro/client';
 
@@ -45,15 +47,23 @@ export declare const assertDeferralSupported: (target: DeferralTarget) => void;
  * `enterWith` is the Node API for exactly this case: it installs the store for
  * the current async context and everything that flows from it, which for a
  * per-request handler is precisely the intended lifetime. Call it once at the
- * top of a render, then read `currentStoreSeeds()` where the payload is built.
+ * top of a render, then read `currentStoreSeeds()` / `currentPreloadSeeds()`
+ * where the payload is built.
  *
  * Do NOT call it from a long-lived context (a module top level, a server
  * bootstrap): there it would install one bag for the whole process, which is
  * the leak the scoping exists to prevent.
+ *
+ * Returns the STORE bag so existing callers keep their `{ seeds }` shape; the
+ * preload bag is installed into the same scope and read via
+ * `currentPreloadSeeds()`.
  */
 export declare const beginStoreSeeds: () => StoreSeedBag;
 
-/** The current request's seeds, or null outside a render. Tests + diagnostics. */
+/** The current request's preloaded-subscription seeds, or null outside a render. */
+export declare const currentPreloadSeeds: () => ReadonlyArray<PreloadSeed> | null;
+
+/** The current request's store seeds, or null outside a render. Tests + diagnostics. */
 export declare const currentStoreSeeds: () => ReadonlyArray<StoreSeed> | null;
 
 /** Render modes / interactive modes a page may combine with `defer()`. */
@@ -153,6 +163,18 @@ export declare interface InlinedRouterState {
         readonly key?: string;
         readonly value: unknown;
     }>;
+    /**
+     * Preloaded-subscription first values the server seeded for this document
+     * (see `seedPreloadedSubscription` in `@voltro/client`). Rides the same
+     * payload as `storeSeeds` for the same reason: one thing to emit, parse, and
+     * remember on all three SSR paths. `mount` applies them before the first
+     * render so `usePreloadedSubscription` shows real data with no flash.
+     */
+    readonly preloadSeeds?: ReadonlyArray<{
+        readonly api: string;
+        readonly key: string;
+        readonly value: unknown;
+    }>;
     /** 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
@@ -316,6 +338,11 @@ declare interface PageMeta {
      *  JSON-serialisable is accepted; `@context` + `@type` are
      *  authored, not synthesised. */
     readonly jsonLd?: ReadonlyArray<Record<string, unknown>>;
+    /** Keep this page out of the index. Emits
+     *  `<meta name="robots" content="noindex, nofollow">`, and the build's
+     *  `sitemap.xml` generator EXCLUDES the route. Use for utility pages
+     *  (checkout steps, previews, thank-you pages) that should not rank. */
+    readonly noIndex?: boolean;
 }
 
 export declare const parseCookieHeader: (raw: string | undefined) => Record<string, string>;
@@ -512,7 +539,8 @@ export declare const renderPageToHtml: (options: RenderPageOptions) => RenderPag
 export declare const renderPageToStream: (options: RenderPageStreamOptions) => RenderPageStreamResult;
 
 /**
- * The hydration payload, with this request's client-store seeds folded in.
+ * The hydration payload, with this request's client-store seeds AND
+ * preloaded-subscription seeds folded in.
  *
  * The fold happens HERE and nowhere else on purpose. There are three
  * independent SSR emitters, and every one of them already calls this function —
@@ -521,8 +549,8 @@ export declare const renderPageToStream: (options: RenderPageStreamOptions) => R
  * passing `storeSeeds` itself) is three chances to forget and one silent
  * difference between environments.
  *
- * An explicit `storeSeeds` on the input still wins, so the build-time prerender
- * can pass a set it computed some other way.
+ * An explicit `storeSeeds` / `preloadSeeds` on the input still wins, so the
+ * build-time prerender can pass a set it computed some other way.
  */
 export declare const renderRouterStateScript: (input: RouterStateInput) => string;
 
@@ -551,6 +579,13 @@ export declare interface RouterStateInput {
         readonly key?: string;
         readonly value: unknown;
     }>;
+    /** Preloaded-subscription first values seeded during this render (see
+     *  `InlinedRouterState`). */
+    readonly preloadSeeds?: ReadonlyArray<{
+        readonly api: string;
+        readonly key: string;
+        readonly value: unknown;
+    }>;
     /** 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
@@ -596,6 +631,8 @@ declare interface RouteSegment {
     readonly loader?: LoaderFn | undefined;
 }
 
+export { seedPreloadedSubscription }
+
 /**
  * Serialise arbitrary data for inlining into an HTML `<script>` body.
  *
@@ -627,6 +664,7 @@ declare interface ServerRequestContextValue {
 export declare const withStoreSeeds: <T>(render: () => Promise<T>) => Promise<{
     readonly result: T;
     readonly storeSeeds: ReadonlyArray<StoreSeed>;
+    readonly preloadSeeds: ReadonlyArray<PreloadSeed>;
 }>;
 
 export { }

package/dist/ssr.js

@@ -1,40 +1,50 @@
-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-DDDBYFrI.js";
-import { c, m as l, r as u, t as d, u as f, w as p } from "./serverContext-BASpdhXG.js";
-import { createElement as m } from "react";
-import { makeStoreSeedBag as h, setStoreSeedResolver as g } from "@voltro/client";
-import { renderToPipeableStream as _, renderToString as v } from "react-dom/server";
-import { AsyncLocalStorage as y } from "node:async_hooks";
+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-CV1ieZKF.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";
 //#region src/storeSeedScope.ts
-var b = new y();
-g(() => b.getStore() ?? null);
-var x = async (e) => {
-	let t = h();
+var w = new C();
+b(() => w.getStore()?.store ?? null), y(() => w.getStore()?.preload ?? null);
+var T = async (e) => {
+	let t = {
+		store: _(),
+		preload: g()
+	};
 	return {
-		result: await b.run(t, e),
-		storeSeeds: t.seeds
+		result: await w.run(t, e),
+		storeSeeds: t.store.seeds,
+		preloadSeeds: t.preload.seeds
+	};
+}, E = () => {
+	let e = {
+		store: _(),
+		preload: g()
 	};
-}, S = () => {
-	let e = h();
-	return b.enterWith(e), e;
-}, C = () => b.getStore()?.seeds ?? null, w = (e) => {
-	let n = C();
-	return t(e.storeSeeds !== void 0 || n === null || n.length === 0 ? e : {
+	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 : {
 		...e,
 		storeSeeds: n
+	};
+	return t(e.preloadSeeds !== void 0 || r === null || r.length === 0 ? i : {
+		...i,
+		preloadSeeds: r
 	});
-}, T = (e, t, n, r) => {
-	let i = m(c.Provider, { value: n }, m(e));
-	if (!t) return i;
+}, A = (e, t, n, r, i) => {
+	let a = h(l.Provider, { value: i ? n : f }, h(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;
-			i = m(c.Provider, { value: r(e) }, m(t, { children: i }));
+			a = h(l.Provider, { value: n.loader === void 0 ? f : r(e) }, h(t, { children: a }));
 		}
 	}
-	return i;
-}, E = (e) => {
-	let { descriptor: t, params: n, pathname: r, loaderData: i, segmentLoaderData: a, requestContext: o, outerWrap: s, locale: c, pageSlot: u } = e, h = p(t.meta, n, i, c), g = {
+	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,
@@ -45,23 +55,23 @@ var x = async (e) => {
 		prefetch: () => {},
 		registerBlocker: () => () => {},
 		blocked: null
-	}, _ = u ? f : t.Component;
+	}, _ = 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 = m(l.Provider, { value: g }, T(_, t.chain, u ? void 0 : i, (e) => a?.[e]));
-	return o && (v = m(d.Provider, { value: o }, v)), s && (v = s(v)), {
+	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: h
+		meta: p
 	};
-}, D = (e) => {
-	let { tree: t, meta: n } = E(e);
+}, M = (e) => {
+	let { tree: t, meta: n } = j(e);
 	return {
-		html: v(t),
+		html: S(t),
 		meta: n
 	};
-}, O = (e) => {
-	let { tree: t, meta: n } = E(e);
+}, N = (e) => {
+	let { tree: t, meta: n } = j(e);
 	return {
-		stream: _(t, {
+		stream: x(t, {
 			...e.bootstrapModules ? { bootstrapModules: [...e.bootstrapModules] } : {},
 			...e.onShellReady ? { onShellReady: e.onShellReady } : {},
 			...e.onShellError ? { onShellError: e.onShellError } : {},
@@ -69,20 +79,20 @@ var x = async (e) => {
 		}),
 		meta: n
 	};
-}, k = (e) => {
+}, P = (e) => {
 	if (!e) return "";
 	let t = [];
-	if (typeof e.title == "string" && t.push(`<title>${A(e.title)}</title>`), e.description && t.push(`<meta name="description" content="${j(e.description)}" />`), e.canonical && t.push(`<link rel="canonical" href="${j(e.canonical)}" />`), e.tags) for (let n of e.tags) {
-		let e = n.name ? `name="${j(n.name)}"` : n.property ? `property="${j(n.property)}"` : "";
-		e && t.push(`<meta ${e} content="${j(n.content)}" />`);
+	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 (e.links) for (let n of e.links) {
 		let e = [
-			`rel="${j(n.rel)}"`,
-			`href="${j(n.href)}"`,
-			n.hreflang ? `hreflang="${j(n.hreflang)}"` : "",
-			n.type ? `type="${j(n.type)}"` : "",
-			n.title ? `title="${j(n.title)}"` : ""
+			`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)}"` : ""
 		].filter(Boolean).join(" ");
 		t.push(`<link ${e} />`);
 	}
@@ -91,6 +101,6 @@ var x = async (e) => {
 		t.push(`<script type="application/ld+json" data-voltro-page-jsonld>${e}<\/script>`);
 	}
 	return t.join("\n    ");
-}, A = (e) => e.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;"), j = (e) => e.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
+}, F = (e) => e.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;"), I = (e) => e.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
 //#endregion
-export { s as ROUTER_STATE_SCRIPT_ID, o as assertDeferralSupported, S as beginStoreSeeds, C as currentStoreSeeds, i as encodeRouterState, a as isDeferredLoaderResult, u as parseCookieHeader, r as prepareDeferredLoaderData, n as renderDeferredRegistryScript, k as renderMetaToHtml, D as renderPageToHtml, O as renderPageToStream, w as renderRouterStateScript, e as serialiseStateForInlining, x as withStoreSeeds };
+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 };

package/package.json

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