@voltro/web 0.54.0 → 0.56.0

package/dist/mount.d.ts

@@ -56,6 +56,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';
 }
 
 export declare const noticeIslandsShipTheFullBundle: (isDev: boolean) => void;

package/dist/mount.js

@@ -1,4 +1,4 @@
-import { t as e } from "./frameworkBoot-CnE9vzLQ.js";
+import { t as e } from "./frameworkBoot-BfJpdpZp.js";
 import { hydrateIslandsOnPage as t } from "./islands.js";
 import { o as n, r, t as i } from "./routerState-Cr6fTbka.js";
 import { StrictMode as a } from "react";
@@ -29,7 +29,8 @@ var d = () => !1, f = "__voltroIslandsBundleNoticeShown", p = (e) => {
 	let S = /* @__PURE__ */ u(a, { children: /* @__PURE__ */ u(e, {
 		App: f,
 		apis: _,
-		...h.Devtools ? { Devtools: h.Devtools } : {}
+		...h.Devtools ? { Devtools: h.Devtools } : {},
+		...h.connect ? { connect: h.connect } : {}
 	}) });
 	b ? s(g, S) : o(g).render(S);
 };

package/dist/ssr.d.ts

@@ -465,6 +465,19 @@ export declare interface PreparedLoaderData {
     readonly deferredIds: Readonly<Record<string, string>> | undefined;
 }
 
+/**
+ * Hand an api's client descriptors to the SERVER render.
+ *
+ * Re-exported here because the CLI cannot import `@voltro/client` directly —
+ * it is a Node process and that package's entry is React/JSX — while this
+ * module is already on the web side of the boundary and is what every SSR
+ * path loads. See `registerSsrDescriptors` for what breaks without it: a
+ * binding-derived prop (a form's fields, labels, required marks) differs
+ * between the server render and the first client render, and React discards
+ * the subtree.
+ */
+export declare const registerSsrApiDescriptors: (apiName: string, descriptors: Readonly<Record<string, never>>) => void;
+
 /**
  * How a page's HTML is produced.
  *

package/dist/ssr.js

@@ -2,30 +2,30 @@ 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";
+import { ServerRequestContext as v, makePreloadSeedBag as y, makeStoreSeedBag as b, registerSsrDescriptors as x, seedPreloadedSubscription as S, seedPreloadedSubscriptionFailure as C, setPreloadSeedResolver as w, setStoreSeedResolver as T } from "@voltro/client";
+import { renderToPipeableStream as E, renderToString as D } from "react-dom/server";
+import { AsyncLocalStorage as O } from "node:async_hooks";
 //#region src/storeSeedScope.ts
-var O = new D();
-w(() => O.getStore()?.store ?? null), C(() => O.getStore()?.preload ?? null);
-var k = async (e) => {
+var k = new O();
+T(() => k.getStore()?.store ?? null), w(() => k.getStore()?.preload ?? null);
+var A = async (e) => {
 	let t = {
 		store: b(),
 		preload: y()
 	};
 	return {
-		result: await O.run(t, e),
+		result: await k.run(t, e),
 		storeSeeds: t.store.seeds,
 		preloadSeeds: t.preload.seeds
 	};
-}, A = () => {
+}, j = () => {
 	let e = {
 		store: b(),
 		preload: y()
 	};
-	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 : {
+	return k.enterWith(e), e.store;
+}, M = () => k.getStore()?.store.seeds ?? null, N = () => k.getStore()?.preload.seeds ?? null, P = (e) => {
+	let t = M(), r = N(), i = e.storeSeeds !== void 0 || t === null || t.length === 0 ? e : {
 		...e,
 		storeSeeds: t
 	};
@@ -33,7 +33,7 @@ var k = async (e) => {
 		...i,
 		preloadSeeds: r
 	});
-}, P = (e, t, n, r, i) => {
+}, F = (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--) {
@@ -44,7 +44,7 @@ var k = async (e) => {
 		}
 	}
 	return a;
-}, F = (t) => {
+}, I = (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 ?? "",
@@ -58,7 +58,7 @@ var k = async (e) => {
 		blocked: null
 	}, 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 = g(h, P(y, n.chain, f ? void 0 : o, (e) => s?.[e], !f && n.loader !== void 0));
+	let b = g(h, F(y, n.chain, f ? void 0 : o, (e) => s?.[e], !f && n.loader !== void 0));
 	return b = _(e, {
 		chrome: null,
 		children: b
@@ -66,16 +66,16 @@ var k = async (e) => {
 		tree: b,
 		meta: m
 	};
-}, I = (e) => {
-	let { tree: t, meta: n } = F(e);
+}, L = (e) => {
+	let { tree: t, meta: n } = I(e);
 	return {
-		html: E(t),
+		html: D(t),
 		meta: n
 	};
-}, L = (e) => {
-	let { tree: t, meta: n } = F(e);
+}, R = (e) => {
+	let { tree: t, meta: n } = I(e);
 	return {
-		stream: T(t, {
+		stream: E(t, {
 			...e.bootstrapModules ? { bootstrapModules: [...e.bootstrapModules] } : {},
 			...e.nonce === void 0 ? {} : { nonce: e.nonce },
 			...e.onShellReady ? { onShellReady: e.onShellReady } : {},
@@ -84,20 +84,20 @@ var k = async (e) => {
 		}),
 		meta: n
 	};
-}, R = (e) => {
+}, z = (e) => {
 	if (!e) return "";
 	let t = [];
-	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 (typeof e.title == "string" && t.push(`<title>${B(e.title)}</title>`), e.description && t.push(`<meta name="description" content="${V(e.description)}" />`), e.noIndex && t.push("<meta name=\"robots\" content=\"noindex, nofollow\" />"), e.canonical && t.push(`<link rel="canonical" href="${V(e.canonical)}" />`), e.tags) for (let n of e.tags) {
+		let e = n.name ? `name="${V(n.name)}"` : n.property ? `property="${V(n.property)}"` : "";
+		e && t.push(`<meta ${e} content="${V(n.content)}" />`);
 	}
 	if (e.links) for (let n of e.links) {
 		let e = [
-			`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)}"` : ""
+			`rel="${V(n.rel)}"`,
+			`href="${V(n.href)}"`,
+			n.hreflang ? `hreflang="${V(n.hreflang)}"` : "",
+			n.type ? `type="${V(n.type)}"` : "",
+			n.title ? `title="${V(n.title)}"` : ""
 		].filter(Boolean).join(" ");
 		t.push(`<link ${e} />`);
 	}
@@ -106,6 +106,6 @@ var k = async (e) => {
 		t.push(`<script type="application/ld+json" data-voltro-page-jsonld>${e}<\/script>`);
 	}
 	return t.join("\n    ");
-}, z = (e) => e.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;"), B = (e) => e.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
+}, B = (e) => e.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;"), V = (e) => e.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;"), H = (e, t) => x(e, t);
 //#endregion
-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 };
+export { c as ROUTER_STATE_SCRIPT_ID, s as assertDeferralSupported, j as beginStoreSeeds, N as currentPreloadSeeds, M as currentStoreSeeds, l as deferredId, r as deferredSettleScript, o as encodeRouterState, a as isDeferredLoaderResult, h as parseCookieHeader, i as prepareDeferredLoaderData, H as registerSsrApiDescriptors, t as renderDeferredRegistryScript, z as renderMetaToHtml, L as renderPageToHtml, R as renderPageToStream, P as renderRouterStateScript, S as seedPreloadedSubscription, C as seedPreloadedSubscriptionFailure, u as serialiseStateForInlining, A as withStoreSeeds };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/web",
-  "version": "0.54.0",
+  "version": "0.56.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",
@@ -63,8 +63,8 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@voltro/client": "0.54.0",
-    "@voltro/ui": "0.54.0"
+    "@voltro/client": "0.56.0",
+    "@voltro/ui": "0.56.0"
   },
   "peerDependencies": {
     "@effect/platform": "^0.97.0",