@voltro/web 0.28.0 → 0.30.0

package/dist/index.d.ts

@@ -5,6 +5,7 @@ import { MouseEvent as MouseEvent_2 } from 'react';
 import { ReactElement } from 'react';
 import { ReactNode } from 'react';
 import { Ref } from 'react';
+import { ResolvableHeaders } from '@voltro/client';
 import { Rpc } from '@effect/rpc';
 import { RpcGroup } from '@effect/rpc';
 
@@ -135,6 +136,12 @@ export declare interface BrowserConsoleBridgeOptions {
     readonly flushAfterMs?: number;
 }
 
+/** Absolute canonical URL for a page. Relative paths are also valid in a
+ *  `<link rel="canonical">` (crawlers resolve them against the document base),
+ *  but an absolute one is unambiguous across environments — pass the production
+ *  `siteUrl` and the page's root-relative `path`. */
+export declare const canonicalUrl: (siteUrl: string, path: string) => string;
+
 /**
  * Structured result of running a route's loaders: the page (leaf) loader's
  * data plus each chain segment's loader data, keyed by segment index.
@@ -425,6 +432,10 @@ export declare const isNotFound: (e: unknown) => e is NotFoundError;
 /** Brand guard — true for any `RedirectError`, even cross-bundle. */
 export declare const isRedirect: (e: unknown) => e is RedirectError;
 
+/** Join an origin (`https://example.com`, optionally with a trailing slash) to a
+ *  root-relative path, collapsing the slash seam so exactly one separates them. */
+export declare const joinUrl: (siteUrl: string, path: string) => string;
+
 /** Lazy variant of `pageRoute`: takes a thunk that dynamically imports the page
  *  instead of an already-imported module. The chunk loads only when the route
  *  first matches — the initial bundle no longer pulls in every page. */
@@ -560,6 +571,11 @@ declare type LoaderEntry<T = unknown> = {
 
 export declare type LoaderFn<T = unknown> = (ctx: LoaderContext) => Promise<T> | T;
 
+/** The URL path a logical page takes for a given locale under URL-prefix
+ *  routing: the default locale keeps the bare path, every other locale gets a
+ *  `/<locale>` prefix. `/about` @ `de` → `/de/about`; @ the default → `/about`. */
+export declare const localizedPath: (path: string, locale: string, defaultLocale: string) => string;
+
 export declare const matchRoute: (compiled: ReadonlyArray<CompiledRoute>, pathname: string) => RouteMatch | null;
 
 /**
@@ -628,6 +644,12 @@ export declare interface NavigateOptions {
 
 export declare const NavigationIndicator: () => ReactNode;
 
+/* Excluded from this release type: NO_LOADER_DATA */
+
+/** Strip a trailing slash from a path, except the root, and guarantee a leading
+ *  slash. `''` and `'/'` both normalise to `'/'`. */
+export declare const normalizePath: (path: string) => string;
+
 /** Construct-and-throw sugar for `NotFoundError`. Typed `: never` so
  *  control-flow narrows at the call site (`const x = row ?? notFound()`). */
 export declare const notFound: (detail?: string) => never;
@@ -737,6 +759,11 @@ export 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 pageRoute: (pattern: string, mod: Record<string, unknown>, extras?: {
@@ -852,16 +879,6 @@ export declare const RENDER_MODES: readonly ["static", "spa", "ssr", "isr"];
  */
 export declare type RenderMode = (typeof RENDER_MODES)[number];
 
-/**
- * Auth headers for an api's WS rpc client. @effect/rpc sends these in the
- * per-request MESSAGE frame (NOT the WS upgrade — a browser can't set upgrade
- * headers), so the server's AuthMiddleware sees them on every call; this is
- * what lets a cross-origin api authenticate WS subscriptions. A thunk is
- * resolved fresh on every (re)connect, so a rotating token (e.g. a Supabase
- * access token) is pulled anew per connect instead of freezing at first mount.
- */
-declare type ResolvableHeaders = Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
-
 /**
  * Decide whether a click on (or inside) an anchor should be handled by the
  * SPA router or left to the browser. Pure — no side effects, no
@@ -991,6 +1008,56 @@ export declare type SearchParamsInit = URLSearchParams | Readonly<Record<string,
  */
 export declare const segmentLoaderKey: (pattern: string, index: number, params: Readonly<Record<string, string>>) => string;
 
+/**
+ * Compute the canonical URL + the full set of `hreflang` alternates for a
+ * localized page. Spread the result straight into a `PageMeta`:
+ *
+ *     export const meta = ({ locale }) => ({
+ *       title: t('about.title'),
+ *       ...seoAlternates({
+ *         siteUrl: 'https://example.com', path: '/about',
+ *         locale, locales: ['en', 'de'], defaultLocale: 'en',
+ *       }),
+ *     })
+ *
+ * `canonical` is the current locale's absolute URL; `links` carries one
+ * `rel="alternate"` per locale (each an ABSOLUTE URL — Google ignores relative
+ * hreflang hrefs) plus the `x-default`. Every page in a locale set should point
+ * its alternates at the SAME set of URLs, including a self-referential one, per
+ * Google's reciprocity rule — which is exactly what iterating `locales` here
+ * produces.
+ */
+export declare const seoAlternates: (input: SeoAlternatesInput) => {
+    readonly canonical: string;
+    readonly links: ReadonlyArray<SeoLink>;
+};
+
+export declare interface SeoAlternatesInput {
+    /** Production origin, e.g. `'https://voltro.dev'`. Absolute URLs are required
+     *  for `hreflang` alternates to be valid, so this is not optional. */
+    readonly siteUrl: string;
+    /** The page's LOGICAL path WITHOUT any locale prefix — the path as the default
+     *  locale serves it (`/plugins/foo`, `/about`, `/`). The current locale's
+     *  prefix is applied by this function, not by the caller. */
+    readonly path: string;
+    /** The locale THIS render is for — drives which URL is `canonical`. */
+    readonly locale: string;
+    /** Every locale the site publishes this page under. */
+    readonly locales: ReadonlyArray<string>;
+    /** The locale served at the bare (un-prefixed) path. */
+    readonly defaultLocale: string;
+    /** Emit an `hreflang="x-default"` alternate pointing at the default-locale URL
+     *  (the recommended fallback for an unmatched language). Default `true`. */
+    readonly xDefault?: boolean;
+}
+
+/** A `<link>` descriptor, structurally the entries `PageMeta.links` accepts. */
+export declare interface SeoLink {
+    readonly rel: string;
+    readonly href: string;
+    readonly hreflang?: string;
+}
+
 export declare interface ServerLogRelay {
     readonly dispose: () => void;
 }
@@ -1142,6 +1209,23 @@ export declare const useLocation: () => string;
 
 export declare const useNavigate: () => RouterContextValue["navigate"];
 
+/**
+ * `useLoaderData()` for a component that may render at a level with no
+ * `loader` — returns `undefined` there instead of throwing.
+ *
+ * This exists for ONE case, and it is worth stating so it is not reached for
+ * casually: a component genuinely shared between routes that declare a loader
+ * and routes that do not. On a page that declares its own `loader`, the router
+ * never renders it without its data, so reaching for the optional read there
+ * only hides a real mistake behind a `?.`.
+ *
+ * Note what it does NOT mean: an empty RESULT is a value, not an absence. A
+ * loader returning `{ items: [] }` returns exactly that through both hooks —
+ * `undefined` here says "there is no loader at this level", never "the query
+ * found nothing".
+ */
+export declare const useOptionalLoaderData: <T>() => LoaderData<T> | undefined;
+
 export declare const useParams: <T extends Record<string, string> = Record<string, string>>() => T;
 
 /** Imperatively pre-warm a route's loader. No-op if the route has no loader. */

package/dist/index.js

@@ -1,29 +1,29 @@
 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-DHdoAwd9.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-BkBY6M2s.js";
 import { a as d, c as f, i as p, l as m, o as h, s as g } from "./defaultFallbacks-Fik_Gcjh.js";
-import { i as _, n as ee, r as te, t as ne } from "./mount-DfyG67bY.js";
-import { c as re, d as ie, h as ae, l as oe, p as se, u as ce } from "./routerState-DDDBYFrI.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, W as A, _ as j, a as M, b as N, c as P, d as F, f as I, g as L, h as R, i as z, j as he, k as ge, l as _e, m as ve, n as ye, o as be, p as xe, r as Se, s as Ce, t as we, u as Te, v as Ee, w as De, x as Oe, y as ke, z as Ae } from "./serverContext-BASpdhXG.js";
-import { Component as je, Suspense as Me, createElement as B, use as Ne, useCallback as Pe, useContext as Fe, useSyncExternalStore as Ie } from "react";
-import { Fragment as V, jsx as H, jsxs as U } from "react/jsx-runtime";
+import { i as _, n as ee, r as te, t as ne } from "./mount-fDzFaIuf.js";
+import { c as re, d as ie, h as ae, l as oe, p as se, u as ce } from "./routerState-DAT472IC.js";
+import { A as le, B as ue, C as de, D as fe, E as pe, F as me, G as he, H as ge, I as _e, K 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, U as D, V as O, W as k, _ as A, a as j, b as M, c as N, d as P, f as F, g as I, h as ve, i as ye, j as be, k as xe, l as Se, m as Ce, n as we, o as Te, p as Ee, r as De, s as Oe, t as ke, u as L, v as Ae, w as je, x as Me, y as Ne, z as Pe } from "./serverContext-CV1ieZKF.js";
+import { Component as Fe, Suspense as Ie, createElement as R, use as Le, useCallback as Re, useContext as ze, useSyncExternalStore as Be } from "react";
+import { Fragment as z, jsx as B, jsxs as V } from "react/jsx-runtime";
 export * from "@voltro/client";
 export * from "@voltro/ui";
 //#region src/await.tsx
-var Le = ({ value: e, fallback: t, children: n, errorFallback: r }) => /* @__PURE__ */ H(Me, {
+var Ve = ({ value: e, fallback: t, children: n, errorFallback: r }) => /* @__PURE__ */ B(Ie, {
 	fallback: t,
-	children: /* @__PURE__ */ H(ze, {
+	children: /* @__PURE__ */ B(Ue, {
 		errorFallback: r,
-		children: /* @__PURE__ */ H(Re, {
+		children: /* @__PURE__ */ B(He, {
 			value: e,
 			errorFallback: r ?? null,
 			children: n
 		})
 	})
-}), W = ({ body: e }) => /* @__PURE__ */ H("script", { dangerouslySetInnerHTML: { __html: e } }), Re = ({ value: e, errorFallback: t, children: n }) => {
-	let r = Ne(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] });
-}, ze = class extends je {
+}), H = ({ body: e }) => /* @__PURE__ */ B("script", { dangerouslySetInnerHTML: { __html: e } }), He = ({ value: e, errorFallback: t, children: n }) => {
+	let r = Le(e), i = ce(e), a = ae(r);
+	return a === void 0 ? /* @__PURE__ */ V(z, { children: [i === void 0 ? null : /* @__PURE__ */ B(H, { body: ie(i, r) }), n(r)] }) : /* @__PURE__ */ V(z, { children: [i === void 0 ? null : /* @__PURE__ */ B(H, { body: oe(i, a) }), t] });
+}, Ue = class extends Fe {
 	state = { error: void 0 };
 	static getDerivedStateFromError(e) {
 		return { error: e };
@@ -31,7 +31,7 @@ var Le = ({ 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 }), Be = ({ loader: e, children: t }) => B(K.Provider, { value: { loader: e } }, t), q = [
+}, U = ({ src: e }) => e, W = e("imageConfig", { loader: U }), We = ({ loader: e, children: t }) => R(W.Provider, { value: { loader: e } }, t), G = [
 	640,
 	750,
 	828,
@@ -40,8 +40,8 @@ var Le = ({ value: e, fallback: t, children: n, errorFallback: r }) => /* @__PUR
 	1920,
 	2048,
 	3840
-], Ve = (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];
+], Ge = (e, t, n, r) => {
+	let i = n !== void 0 && !r ? Array.from(new Set(G.filter((e) => e <= n * 2).concat(n))).sort((e, t) => e - t) : [...G];
 	return {
 		srcSet: i.map((n) => `${e({
 			src: t,
@@ -52,10 +52,10 @@ var Le = ({ value: e, fallback: t, children: n, errorFallback: r }) => /* @__PUR
 			width: i[i.length - 1]
 		})
 	};
-}, He = ({ 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 = Fe(K).loader, p = s ?? f;
+}, Ke = ({ 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 = ze(W).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 } = Ve(p, e, n, i), g = c === "blur" && l ? {
+	let { srcSet: m, fallback: h } = Ge(p, e, n, i), g = c === "blur" && l ? {
 		backgroundImage: `url(${l})`,
 		backgroundSize: "cover",
 		backgroundPosition: "center"
@@ -66,7 +66,7 @@ var Le = ({ value: e, fallback: t, children: n, errorFallback: r }) => /* @__PUR
 		width: "100%",
 		objectFit: "cover"
 	} : {};
-	return B("img", {
+	return R("img", {
 		src: h,
 		srcSet: m,
 		sizes: a ?? (i ? "100vw" : void 0),
@@ -85,10 +85,10 @@ var Le = ({ value: e, fallback: t, children: n, errorFallback: r }) => /* @__PUR
 		},
 		...d
 	});
-}, Ue = ({ to: e, children: t, className: n }) => B("a", {
+}, qe = ({ to: e, children: t, className: n }) => R("a", {
 	href: e,
 	className: n
-}, t), We = {
+}, t), Je = {
 	position: "sticky",
 	top: 0,
 	zIndex: 10,
@@ -99,13 +99,13 @@ var Le = ({ 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)"
-}, Ge = {
+}, Ye = {
 	maxWidth: "48rem",
 	margin: "0 auto",
 	padding: "2rem 1.5rem",
 	width: "100%"
-}, Ke = (e) => {
-	let { brand: t, topNav: n, children: r, pathname: i, footer: a, breadcrumbs: o, headerRight: s } = e, c = e.Link ?? Ue, l = B("nav", {
+}, Xe = (e) => {
+	let { brand: t, topNav: n, children: r, pathname: i, footer: a, breadcrumbs: o, headerRight: s } = e, c = e.Link ?? qe, l = R("nav", {
 		className: "voltro-blog-nav",
 		style: {
 			display: "flex",
@@ -114,20 +114,20 @@ var Le = ({ value: e, fallback: t, children: n, errorFallback: r }) => /* @__PUR
 		}
 	}, ...n.map((e) => {
 		let t = i === e.href;
-		return B(c, {
+		return R(c, {
 			key: e.href,
 			to: e.href,
 			className: t ? "voltro-blog-nav-link is-active" : "voltro-blog-nav-link",
 			children: e.label
 		});
-	})), u = B("header", {
+	})), u = R("header", {
 		className: "voltro-blog-header",
-		style: We
-	}, B("div", { className: "voltro-blog-brand" }, t), s ? B("div", { style: {
+		style: Je
+	}, R("div", { className: "voltro-blog-brand" }, t), s ? R("div", { style: {
 		display: "flex",
 		gap: "1rem",
 		alignItems: "center"
-	} }, l, s) : l), d = o && o.length > 0 ? B("nav", {
+	} }, l, s) : l), d = o && o.length > 0 ? R("nav", {
 		className: "voltro-blog-breadcrumbs",
 		"aria-label": "Breadcrumb",
 		style: {
@@ -138,20 +138,20 @@ var Le = ({ value: e, fallback: t, children: n, errorFallback: r }) => /* @__PUR
 			gap: "0.5rem"
 		}
 	}, ...o.flatMap((e, t) => {
-		let n = t === o.length - 1, r = e.href && !n ? B(c, {
+		let n = t === o.length - 1, r = e.href && !n ? R(c, {
 			key: `c${t}`,
 			to: e.href,
 			children: e.label
-		}) : B("span", {
+		}) : R("span", {
 			key: `c${t}`,
 			"aria-current": n ? "page" : void 0
 		}, e.label);
-		return n ? [r] : [r, B("span", { key: `s${t}` }, "/")];
+		return n ? [r] : [r, R("span", { key: `s${t}` }, "/")];
 	})) : null;
-	return B("div", { className: "voltro-blog-layout" }, u, B("main", {
+	return R("div", { className: "voltro-blog-layout" }, u, R("main", {
 		className: "voltro-blog-main",
-		style: Ge
-	}, d, r), a ? B("footer", {
+		style: Ye
+	}, d, r), a ? R("footer", {
 		className: "voltro-blog-footer",
 		style: {
 			maxWidth: "48rem",
@@ -160,7 +160,31 @@ var Le = ({ 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", qe = 31536e3, Je = () => {
+}, K = (e) => {
+	if (e === "" || e === "/") return "/";
+	let t = e.startsWith("/") ? e : `/${e}`;
+	return t.endsWith("/") ? t.slice(0, -1) : t;
+}, q = (e, t) => {
+	let n = e.endsWith("/") ? e.slice(0, -1) : e, r = K(t);
+	return r === "/" ? `${n}/` : `${n}${r}`;
+}, J = (e, t, n) => {
+	let r = K(e);
+	return t === n ? r : r === "/" ? `/${t}` : `/${t}${r}`;
+}, Ze = (e, t) => q(e, t), Qe = (e) => {
+	let { siteUrl: t, path: n, locale: r, locales: i, defaultLocale: a, xDefault: o = !0 } = e, s = q(t, J(n, r, a)), c = i.map((e) => ({
+		rel: "alternate",
+		hreflang: e,
+		href: q(t, J(n, e, a))
+	}));
+	return o && c.push({
+		rel: "alternate",
+		hreflang: "x-default",
+		href: q(t, J(n, a, a))
+	}), {
+		canonical: s,
+		links: c
+	};
+}, Y = "voltro:theme", $e = 31536e3, et = () => {
 	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 +192,17 @@ var Le = ({ value: e, fallback: t, children: n, errorFallback: r }) => /* @__PUR
 	} catch {
 		return "system";
 	}
-}, Y = () => {
+}, tt = () => {
 	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" ? tt() ? "dark" : "light" : e, Z = 0, Q = /* @__PURE__ */ new Set(), $ = () => {
 	Z++;
 	for (let e of Q) e();
-}, Ye = (e) => {
+}, nt = (e) => {
 	Q.add(e);
 	let t, n = () => $();
 	if (typeof window < "u" && window.matchMedia) try {
@@ -190,21 +214,21 @@ var Le = ({ value: e, fallback: t, children: n, errorFallback: r }) => /* @__PUR
 			t?.removeEventListener("change", n);
 		} catch {}
 	};
-}, Xe = () => {
-	let e = Je();
+}, rt = () => {
+	let e = et();
 	return `${Z}:${e}:${X(e)}`;
-}, Ze = () => "0:system:light", Qe = () => {
-	let [, e, t] = Ie(Ye, Xe, Ze).split(":");
+}, it = () => "0:system:light", at = () => {
+	let [, e, t] = Be(nt, rt, it).split(":");
 	return {
 		theme: e,
 		resolvedTheme: t,
-		setTheme: Pe((e) => {
+		setTheme: Re((e) => {
 			if (typeof document < "u") try {
-				document.cookie = e === "system" ? `${J}=; path=/; max-age=0; SameSite=Lax` : `${J}=${e}; path=/; max-age=${qe}; SameSite=Lax`, document.documentElement.classList.toggle("dark", X(e) === "dark");
+				document.cookie = e === "system" ? `${Y}=; path=/; max-age=0; SameSite=Lax` : `${Y}=${e}; path=/; max-age=${$e}; SameSite=Lax`, document.documentElement.classList.toggle("dark", X(e) === "dark");
 			} catch {}
 			$();
 		}, [])
 	};
-}, $e = "framework-web";
+}, ot = "framework-web";
 //#endregion
-export { t as AppClientsContext, Le as Await, Ke as BlogLayout, p as FallbackStringsProvider, He as Image, Be as ImageConfigProvider, be as Link, Ce as LoaderCache, P as LoaderDataContext, i as NavigationIndicator, y as NotFoundError, _e as PAGE_SLOT_ATTR, Te as PageSlot, F as PlainLink, I as RENDER_MODES, o as ReconnectContext, b as RedirectError, xe as Router, ve as RouterContext, we as ServerRequestContext, ye as ServerRequestProvider, J as THEME_COOKIE, $e as WEB_NAME, R as compileRoute, d as defaultFallbackStrings, re as defer, L as externalUrl, j as findNotFound, c as formatPrintf, ee as getIslandComponent, v as getRouteSnapshot, g as getStatuses, te as hydrateIslandsOnPage, a as installBrowserConsoleBridge, r as installServerLogRelay, se as isDeferredLoaderResult, T as isNotFound, Ae as isRedirect, _ as island, Ee as lazyPageRoute, ke as loaderCacheKey, N as matchRoute, ne as mount, ue as notFound, Oe as pageRoute, Se as parseCookieHeader, G as passthroughImageLoader, E as preloadRouteModule, f as pushStatus, k as redirect, s as registerClientTrace, de as resolveAnchorNavigation, De as resolveMeta, D as segmentLoaderKey, O as setRouteSnapshot, pe as sortRoutesByPriority, A as subscribeRouteSnapshot, m as subscribeStatuses, l as subscribeTraceErrors, n as useAppClient, fe as useBlocker, h as useFallbackStrings, C as useLoaderData, ge as useLocation, le as useNavigate, he as useParams, x as usePrefetch, u as useReconnect, z as useSearchParams, M as useServerRequest, S as useSetSearchParams, Qe as useTheme, w as withHash, me as withQuery };
+export { t as AppClientsContext, Ve as Await, Xe as BlogLayout, p as FallbackStringsProvider, Ke as Image, We as ImageConfigProvider, Te as Link, Oe as LoaderCache, N as LoaderDataContext, Se as NO_LOADER_DATA, i as NavigationIndicator, w as NotFoundError, L as PAGE_SLOT_ATTR, P as PageSlot, F as PlainLink, Ee as RENDER_MODES, o as ReconnectContext, Pe as RedirectError, Ce as Router, ve as RouterContext, ke as ServerRequestContext, we as ServerRequestProvider, Y as THEME_COOKIE, ot as WEB_NAME, Ze as canonicalUrl, I as compileRoute, d as defaultFallbackStrings, re as defer, A as externalUrl, Ae 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, ue as isNotFound, O as isRedirect, _ as island, q as joinUrl, Ne as lazyPageRoute, M as loaderCacheKey, J as localizedPath, Me as matchRoute, ne as mount, K as normalizePath, ge as notFound, T as pageRoute, De as parseCookieHeader, U as passthroughImageLoader, de as preloadRouteModule, f as pushStatus, D as redirect, s as registerClientTrace, je as resolveAnchorNavigation, E as resolveMeta, pe as segmentLoaderKey, Qe as seoAlternates, he as setRouteSnapshot, fe as sortRoutesByPriority, v as subscribeRouteSnapshot, m as subscribeStatuses, l as subscribeTraceErrors, n as useAppClient, S as useBlocker, h as useFallbackStrings, xe as useLoaderData, le as useLocation, be as useNavigate, b as useOptionalLoaderData, x as useParams, C as usePrefetch, u as useReconnect, ye as useSearchParams, j as useServerRequest, me as useSetSearchParams, at as useTheme, _e as withHash, y as withQuery };

package/dist/{mount-DfyG67bY.js → mount-fDzFaIuf.js}

@@ -1,35 +1,35 @@
-import { t as e } from "./frameworkBoot-DHdoAwd9.js";
-import { o as t, r as n, t as r } from "./routerState-DDDBYFrI.js";
+import { t as e } from "./frameworkBoot-BkBY6M2s.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 { applyStoreSeeds as c } from "@voltro/client";
-import { jsx as l } from "react/jsx-runtime";
+import { applyPreloadSeeds as c, applyStoreSeeds as l } from "@voltro/client";
+import { jsx as u } from "react/jsx-runtime";
 //#region src/islands.tsx
-var u = /* @__PURE__ */ new Map(), d = (e, t) => {
-	u.set(t.name, e);
+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": p(r)
+		"data-island-props": m(r)
 	}, a(e, r));
 	return r.displayName = `Island(${t.name})`, r;
-}, f = (e) => u.get(e), p = (e) => JSON.stringify(e ?? {}).replace(/</g, "\\u003c"), m = (e) => {
+}, 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 {};
 	}
-}, h = () => {
+}, g = () => {
 	let e = document.querySelectorAll("[data-voltro-island]:not([data-voltro-hydrated])");
 	for (let t of e) {
-		let e = t.dataset.islandName ?? "", n = u.get(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 = m(t.dataset.islandProps ?? null), i = t.dataset.islandHydrate ?? "visible";
+		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)));
@@ -50,28 +50,28 @@ var u = /* @__PURE__ */ new Map(), d = (e, t) => {
 			t.addEventListener("pointerdown", e, { passive: !0 }), t.addEventListener("keydown", e);
 		}
 	}
-}, g = (e) => `${window.location.protocol === "https:" ? "wss:" : "ws:"}//${window.location.host}/ws/${e}`, _ = (a, u) => {
-	let d = document.getElementById(u.rootId ?? "root");
-	if (!d) throw Error(`@voltro/web: no #${u.rootId ?? "root"} element in the document`);
-	let f = Object.entries(u.apis).map(([e, t]) => ({
+}, _ = (e) => `${window.location.protocol === "https:" ? "wss:" : "ws:"}//${window.location.host}/ws/${e}`, v = (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 ?? g(e),
+		wsUrl: t.wsUrl ?? _(e),
 		headers: t.headers
-	})), p = n(document.getElementById(r)?.textContent, window.location.pathname), m = p !== null && d.children.length > 0, _ = document.querySelector("meta[name=\"voltro-interactive\"]")?.getAttribute("content") ?? "full";
-	if (_ === "none") return;
-	if (_ === "islands") {
-		h();
+	})), m = n(document.getElementById(r)?.textContent, window.location.pathname), h = m !== null && f.children.length > 0, v = document.querySelector("meta[name=\"voltro-interactive\"]")?.getAttribute("content") ?? "full";
+	if (v === "none") return;
+	if (v === "islands") {
+		g();
 		return;
 	}
-	m && t(p), c(p?.storeSeeds);
-	let v = /* @__PURE__ */ l(i, { children: /* @__PURE__ */ l(e, {
+	h && t(m), l(m?.storeSeeds), c(m?.preloadSeeds);
+	let y = /* @__PURE__ */ u(i, { children: /* @__PURE__ */ u(e, {
 		App: a,
-		apis: f,
-		...u.Devtools ? { Devtools: u.Devtools } : {}
+		apis: p,
+		...d.Devtools ? { Devtools: d.Devtools } : {}
 	}) });
-	m ? s(d, v) : o(d).render(v);
+	h ? s(f, y) : o(f).render(y);
 };
 //#endregion
-export { d as i, f as n, h as r, _ as t };
+export { f as i, p as n, g as r, v as t };

package/dist/mount.d.ts

@@ -1,4 +1,5 @@
 import { ComponentType } from 'react';
+import { ResolvableHeaders } from '@voltro/client';
 import { Rpc } from '@effect/rpc';
 import { RpcGroup } from '@effect/rpc';
 
@@ -57,14 +58,4 @@ export declare interface MountOptions {
     readonly Devtools?: ComponentType;
 }
 
-/**
- * Auth headers for an api's WS rpc client. @effect/rpc sends these in the
- * per-request MESSAGE frame (NOT the WS upgrade — a browser can't set upgrade
- * headers), so the server's AuthMiddleware sees them on every call; this is
- * what lets a cross-origin api authenticate WS subscriptions. A thunk is
- * resolved fresh on every (re)connect, so a rotating token (e.g. a Supabase
- * access token) is pulled anew per connect instead of freezing at first mount.
- */
-declare type ResolvableHeaders = Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
-
 export { }

package/dist/mount.js

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

package/dist/{routerState-DDDBYFrI.js → routerState-DAT472IC.js}

@@ -69,6 +69,7 @@ var e = /* @__PURE__ */ RegExp("\\u2028", "g"), t = /* @__PURE__ */ RegExp("\\u2
 		},
 		...e.pageClientOnly ? { pageClientOnly: !0 } : {},
 		...e.storeSeeds !== void 0 && e.storeSeeds.length > 0 ? { storeSeeds: e.storeSeeds } : {},
+		...e.preloadSeeds !== void 0 && e.preloadSeeds.length > 0 ? { preloadSeeds: e.preloadSeeds } : {},
 		...n || r ? { deferred: {
 			...n ? { page: e.deferredPageIds } : {},
 			...r ? { segments: e.deferredSegmentIds } : {}
@@ -99,7 +100,8 @@ var e = /* @__PURE__ */ RegExp("\\u2028", "g"), t = /* @__PURE__ */ RegExp("\\u2
 		segments: a.size > 0 ? a : T,
 		pageClientOnly: r.pageClientOnly === !0,
 		pathname: t,
-		storeSeeds: Array.isArray(r.storeSeeds) ? r.storeSeeds : []
+		storeSeeds: Array.isArray(r.storeSeeds) ? r.storeSeeds : [],
+		preloadSeeds: Array.isArray(r.preloadSeeds) ? r.preloadSeeds : []
 	};
 }, O = (e, t) => {
 	if (!t) return e;