camox 0.43.0 → 0.45.0

package/dist/features/runtime/llmsTxt.js

@@ -0,0 +1,40 @@
+//#region src/features/runtime/llmsTxt.ts
+/** At most this many pages of a derived layout are listed; the sitemap lists them all. */
+const LLMS_TXT_DERIVED_LAYOUT_CAP = 100;
+/** Text that can't break out of a list entry or a blockquote, whatever Markdown it holds. */
+function escapeMarkdown(text) {
+	return text.replace(/\s+/g, " ").trim().replace(/[\\`*_[\]<>]/g, "\\$&");
+}
+/** A URL that can't end its Markdown link early. */
+function escapeLinkTarget(url) {
+	return url.replace(/\s/g, encodeURIComponent).replace(/\(/g, "%28").replace(/\)/g, "%29");
+}
+function markdownPath(page) {
+	if (!page.hasMarkdown) return page.fullPath;
+	return page.fullPath === "/" ? "/index.md" : `${page.fullPath}.md`;
+}
+/**
+* The website's index for LLMs, following llmstxt.org: the project's name, the home page's
+* description, then a section per layout, in the app's order, linking each page's Markdown.
+*/
+function formatLlmsTxt({ projectName, pages, layouts, url }) {
+	const link = (text, path) => `[${escapeMarkdown(text)}](${escapeLinkTarget(url(path))})`;
+	const lines = [`# ${escapeMarkdown(projectName)}`];
+	const summary = pages.find((page) => page.fullPath === "/")?.description;
+	if (summary) lines.push("", `> ${escapeMarkdown(summary)}`);
+	for (const layout of layouts) {
+		const entries = pages.filter((page) => page.layoutId === layout.id).sort((a, b) => a.fullPath < b.fullPath ? -1 : a.fullPath > b.fullPath ? 1 : 0);
+		if (entries.length === 0) continue;
+		const cap = layout.kind === "derived" ? 100 : Infinity;
+		lines.push("", `## ${escapeMarkdown(layout.title)}`, "");
+		for (const page of entries.slice(0, cap)) {
+			const description = page.description ? `: ${escapeMarkdown(page.description)}` : "";
+			lines.push(`- ${link(page.title, markdownPath(page))}${description}`);
+		}
+		if (entries.length > cap) lines.push("", `${entries.length - cap} more ${escapeMarkdown(layout.title)} pages are listed in the ${link("sitemap", "/sitemap.xml")}.`);
+	}
+	return `${lines.join("\n")}\n`;
+}
+
+//#endregion
+export { formatLlmsTxt };

package/dist/features/runtime/loopbackFetch.js

@@ -0,0 +1,18 @@
+//#region src/features/runtime/loopbackFetch.ts
+/**
+* Browsers resolve any `*.localhost` name to loopback, but the Workers runtime asks the
+* OS, which need not. Local dev servers (like the per-checkout API) use such names, so
+* the dev worker reaches them on 127.0.0.1 instead.
+*/
+function fetchLocalhostOnLoopback(fetch) {
+	return (input, init) => {
+		const request = new Request(input, init);
+		const url = new URL(request.url);
+		if (!url.hostname.endsWith(".localhost")) return fetch(request);
+		url.hostname = "127.0.0.1";
+		return fetch(new Request(url, request));
+	};
+}
+
+//#endregion
+export { fetchLocalhostOnLoopback };

package/dist/features/runtime/navigationAccessibility.js

@@ -0,0 +1,51 @@
+//#region src/features/runtime/navigationAccessibility.ts
+/**
+* What assistive technology gets from a client navigation, which the browser only provides for
+* document loads: focus that starts over on the new page, and the new page's name read out.
+*/
+/** Focuses `element` without scrolling, even if it can't take focus by itself. */
+function focusWithoutScrolling(element) {
+	if (element.tabIndex >= 0 || element.hasAttribute("tabindex")) {
+		element.focus({ preventScroll: true });
+		return;
+	}
+	element.setAttribute("tabindex", "-1");
+	element.focus({ preventScroll: true });
+	element.addEventListener("blur", () => element.removeAttribute("tabindex"), { once: true });
+}
+/**
+* Moves focus within the page `doc` just rendered, as a document load would: to the fragment's
+* element, so Tab continues from there, or else to the start of the page. Focus outside the page,
+* like in Studio, stays where it is.
+*/
+function focusNewPage(doc, fragment) {
+	if (!doc.hasFocus()) return;
+	const target = fragment ?? doc.body;
+	if (target) focusWithoutScrolling(target);
+}
+const visuallyHidden = "position:absolute;width:1px;height:1px;margin:-1px;padding:0;border:0;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap";
+/**
+* A live region in `doc` that reads out each page navigated to. It exists before the first
+* announcement, as screen readers only read changes to regions they already know.
+*/
+function createRouteAnnouncer(doc) {
+	const region = doc.createElement("div");
+	region.setAttribute("aria-live", "assertive");
+	region.setAttribute("aria-atomic", "true");
+	region.setAttribute("data-camox-route-announcer", "");
+	region.setAttribute("style", visuallyHidden);
+	doc.body.append(region);
+	return {
+		/** Reads out the page `page` shows: its title, else its main heading, else its path. */
+		announce(page, pathname) {
+			const name = doc.title || page.title || page.querySelector("h1")?.textContent?.trim() || pathname;
+			region.textContent = name;
+		},
+		dispose() {
+			region.remove();
+		}
+	};
+}
+
+//#endregion
+export { createRouteAnnouncer, focusNewPage };

package/dist/features/runtime/navigationTarget.js

@@ -1,9 +1,30 @@
+import { localeHeaders } from "../../lib/locale-path.js";
+import { matchRuntimeOwnedRoute } from "./runtimeRoutes.js";
+
 //#region src/features/runtime/navigationTarget.ts
 function runtimePath(pathname, basePath) {
 	const base = basePath.replace(/\/$/, "");
 	if (!base || pathname === base || pathname.startsWith(`${base}/`)) return pathname;
 	return `${base}${pathname.startsWith("/") ? pathname : `/${pathname}`}`;
 }
+/**
+* Requests one of the runtime's JSON endpoints (`/_camox/data`, `/_camox/routes`) as the editor,
+* reading `draft` (null for Live) in `locale` (the default locale without it). Dev mode's runtime
+* always reads the development draft. A path the endpoint takes names its own locale by its
+* prefix; route discovery, which takes none, reads the locale the request names.
+*/
+function fetchRuntimeJson(draftScope, endpoint, runtimeBasePath, params, draft, signal, locale) {
+	const url = new URL(runtimePath(endpoint, runtimeBasePath), window.location.origin);
+	for (const [name, value] of Object.entries(params)) url.searchParams.set(name, value);
+	return fetch(new URL(draftScope.hrefFor(url.href, { draft })), {
+		credentials: "same-origin",
+		headers: {
+			Accept: "application/json",
+			...localeHeaders(locale)
+		},
+		signal
+	});
+}
 function getNavigationTarget(to, currentHref, basePath) {
 	const url = new URL(to, currentHref);
 	const current = new URL(currentHref);
@@ -11,7 +32,7 @@ function getNavigationTarget(to, currentHref, basePath) {
 	const base = basePath.replace(/\/$/, "");
 	if (base && /^(https?:)?\/\//.test(to) && url.pathname !== base && !url.pathname.startsWith(`${base}/`)) return null;
 	const pathname = base && (url.pathname === base || url.pathname.startsWith(`${base}/`)) ? url.pathname.slice(base.length) || "/" : url.pathname;
-	if (pathname === "/_camox" || pathname.startsWith("/_camox/") || pathname === "/og" || pathname === "/sitemap.xml") return null;
+	if (pathname === "/_camox" || pathname.startsWith("/_camox/") || matchRuntimeOwnedRoute(pathname)) return null;
 	url.pathname = runtimePath(pathname, base);
 	return {
 		url,
@@ -20,4 +41,4 @@ function getNavigationTarget(to, currentHref, basePath) {
 }
 
 //#endregion
-export { getNavigationTarget, runtimePath };
+export { fetchRuntimeJson, getNavigationTarget, runtimePath };

package/dist/features/runtime/pageApp.js

@@ -1,39 +1,38 @@
 import { useAuthState, useSignInRedirect } from "../../lib/auth.js";
+import { DraftScopeContext } from "../../lib/draft-scope.js";
+import { DerivedPageContent } from "../page/DerivedPageContent.js";
 import { PreviewDocumentContext } from "./PreviewDocumentContext.js";
 import { PreviewActivation } from "../preview/components/PreviewActivation.js";
 import { Frame } from "../preview/components/Frame.js";
+import { PreviewSignInPage } from "../provider/PreviewSignInPage.js";
 import { CoreCamoxProvider, isLocalhostPreview } from "../provider/CoreCamoxProvider.js";
-import { DerivedPageContent } from "../page/DerivedPageContent.js";
-import { PublishedPageExperience } from "../page/PublishedPageExperience.js";
+import { CuratedPageContent } from "../page/CuratedPageContent.js";
+import { EditingFallbackSlot } from "./editingFallback.js";
 import { PageNavigationProvider } from "./pageNavigation.js";
-import { RuntimeChrome } from "./RuntimeChrome.js";
+import { RuntimeChromeSlot } from "./runtimeChromeLoader.js";
 import { c } from "react/compiler-runtime";
-import { HydrationBoundary, QueryClientProvider } from "@tanstack/react-query";
 import * as React from "react";
-import { jsx } from "react/jsx-runtime";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { HydrationBoundary, QueryClientProvider } from "@tanstack/react-query";
 
 //#region src/features/runtime/pageApp.tsx
+/** The page app of one server request or browser window, viewing the draft `draftScope` names. */
 function PageApp(t0) {
-	const $ = c(19);
-	if ($[0] !== "9929b5234f34e8dc8642da9eb491a90e9a57f3ab875ddfc1a186f42f4452f2f5") {
-		for (let $i = 0; $i < 19; $i += 1) $[$i] = Symbol.for("react.memo_cache_sentinel");
-		$[0] = "9929b5234f34e8dc8642da9eb491a90e9a57f3ab875ddfc1a186f42f4452f2f5";
-	}
-	const { camoxApp, input, queryClient } = t0;
+	const $ = c(22);
+	const { camoxApp, draftScope, input, queryClient } = t0;
 	const t1 = input.dehydratedState;
 	let t2;
-	if ($[1] !== camoxApp || $[2] !== input.apiUrl || $[3] !== input.authenticationUrl || $[4] !== input.environmentName || $[5] !== input.presentation || $[6] !== input.projectSlug || $[7] !== queryClient) {
+	if ($[0] !== camoxApp || $[1] !== input.apiUrl || $[2] !== input.authenticationUrl || $[3] !== input.presentation || $[4] !== input.previewHandoff || $[5] !== input.projectUuid || $[6] !== queryClient) {
 		t2 = (currentInput) => /* @__PURE__ */ jsx(CoreCamoxProvider, {
 			camoxApp,
 			authenticationUrl: input.authenticationUrl,
 			apiUrl: input.apiUrl,
-			projectSlug: input.projectSlug,
-			environmentName: input.environmentName,
+			projectUuid: input.projectUuid,
 			initialAuthenticated: input.presentation === "studio",
 			initialProject: currentInput.project,
 			children: /* @__PURE__ */ jsx(PreviewDocumentContext.Provider, {
 				value: currentInput.previewDocument,
-				children: /* @__PURE__ */ jsx(PageExperience, {
+				children: input.previewHandoff ? /* @__PURE__ */ jsx(PreviewSignInPage, {}) : /* @__PURE__ */ jsx(PageExperience, {
 					camoxApp,
 					input: currentInput,
 					queryClient,
@@ -41,22 +40,24 @@ function PageApp(t0) {
 				})
 			})
 		});
-		$[1] = camoxApp;
-		$[2] = input.apiUrl;
-		$[3] = input.authenticationUrl;
-		$[4] = input.environmentName;
-		$[5] = input.presentation;
-		$[6] = input.projectSlug;
-		$[7] = queryClient;
-		$[8] = t2;
-	} else t2 = $[8];
+		$[0] = camoxApp;
+		$[1] = input.apiUrl;
+		$[2] = input.authenticationUrl;
+		$[3] = input.presentation;
+		$[4] = input.previewHandoff;
+		$[5] = input.projectUuid;
+		$[6] = queryClient;
+		$[7] = t2;
+	} else t2 = $[7];
 	let t3;
-	if ($[9] !== input || $[10] !== queryClient || $[11] !== t2) {
+	if ($[8] !== camoxApp || $[9] !== input || $[10] !== queryClient || $[11] !== t2) {
 		t3 = /* @__PURE__ */ jsx(PageNavigationProvider, {
+			camoxApp,
 			initialInput: input,
 			queryClient,
 			children: t2
 		});
+		$[8] = camoxApp;
 		$[9] = input;
 		$[10] = queryClient;
 		$[11] = t2;
@@ -73,19 +74,34 @@ function PageApp(t0) {
 		$[15] = t4;
 	} else t4 = $[15];
 	let t5;
-	if ($[16] !== queryClient || $[17] !== t4) {
-		t5 = /* @__PURE__ */ jsx(QueryClientProvider, {
-			client: queryClient,
+	if ($[16] !== draftScope || $[17] !== t4) {
+		t5 = /* @__PURE__ */ jsx(DraftScopeContext.Provider, {
+			value: draftScope,
 			children: t4
 		});
-		$[16] = queryClient;
+		$[16] = draftScope;
 		$[17] = t4;
 		$[18] = t5;
 	} else t5 = $[18];
-	return t5;
+	let t6;
+	if ($[19] !== queryClient || $[20] !== t5) {
+		t6 = /* @__PURE__ */ jsx(QueryClientProvider, {
+			client: queryClient,
+			children: t5
+		});
+		$[19] = queryClient;
+		$[20] = t5;
+		$[21] = t6;
+	} else t6 = $[21];
+	return t6;
 }
 const LazyEditablePageExperience = React.lazy(() => import("../preview/EditablePageExperience.js").then((module) => ({ default: module.EditablePageExperience })));
 const LazyLocalhostPreviewProvider = React.lazy(() => import("../provider/LocalhostPreviewProvider.js").then((module) => ({ default: module.LocalhostPreviewProvider })));
+/** Editing lists and adds any block, so it waits for every definition, not only the page's. */
+function AllBlocks({ camoxApp, children }) {
+	React.use(camoxApp.loadAllBlocks());
+	return children;
+}
 var EditingActivationBoundary = class extends React.Component {
 	state = { failed: false };
 	static getDerivedStateFromError() {
@@ -100,157 +116,185 @@ var EditingActivationBoundary = class extends React.Component {
 };
 const subscribeToHydration = () => () => {};
 function PageExperience(t0) {
-	const $ = c(39);
-	if ($[0] !== "9929b5234f34e8dc8642da9eb491a90e9a57f3ab875ddfc1a186f42f4452f2f5") {
-		for (let $i = 0; $i < 39; $i += 1) $[$i] = Symbol.for("react.memo_cache_sentinel");
-		$[0] = "9929b5234f34e8dc8642da9eb491a90e9a57f3ab875ddfc1a186f42f4452f2f5";
-	}
+	const $ = c(46);
 	const { camoxApp, input, queryClient, studioDocument } = t0;
 	const { isAuthenticated, isLoading } = useAuthState();
 	const hasHydrated = React.useSyncExternalStore(subscribeToHydration, _temp, _temp2);
 	const signIn = useSignInRedirect();
+	const studioOnly = !!input.routeKind || !!input.canvasOnly;
 	let t1;
 	let t2;
-	if ($[1] !== input.routeKind || $[2] !== isAuthenticated || $[3] !== isLoading || $[4] !== signIn) {
+	if ($[0] !== isAuthenticated || $[1] !== isLoading || $[2] !== signIn || $[3] !== studioOnly) {
 		t1 = () => {
-			if (input.routeKind && !isAuthenticated && !isLoading) signIn();
+			if (studioOnly && !isAuthenticated && !isLoading) signIn();
 		};
 		t2 = [
-			input.routeKind,
+			studioOnly,
 			isAuthenticated,
 			isLoading,
 			signIn
 		];
-		$[1] = input.routeKind;
-		$[2] = isAuthenticated;
-		$[3] = isLoading;
-		$[4] = signIn;
-		$[5] = t1;
-		$[6] = t2;
+		$[0] = isAuthenticated;
+		$[1] = isLoading;
+		$[2] = signIn;
+		$[3] = studioOnly;
+		$[4] = t1;
+		$[5] = t2;
 	} else {
-		t1 = $[5];
-		t2 = $[6];
+		t1 = $[4];
+		t2 = $[5];
 	}
 	React.useEffect(t1, t2);
 	let t3;
-	if ($[7] !== camoxApp || $[8] !== input.derived || $[9] !== input.routeKind || $[10] !== input.source) {
-		t3 = input.routeKind ? /* @__PURE__ */ jsx("div", {
+	if ($[6] === Symbol.for("react.memo_cache_sentinel")) {
+		t3 = /* @__PURE__ */ jsx("div", {
 			className: "text-muted-foreground p-6 text-sm",
 			children: "Loading Studio…"
-		}) : input.derived ? /* @__PURE__ */ jsx(DerivedPageContent, {
+		});
+		$[6] = t3;
+	} else t3 = $[6];
+	const loading = t3;
+	let t4;
+	if ($[7] !== camoxApp || $[8] !== input.canvasOnly || $[9] !== input.derived || $[10] !== input.routeKind) {
+		t4 = input.routeKind ? loading : input.canvasOnly ? null : input.derived ? /* @__PURE__ */ jsx(DerivedPageContent, {
 			camoxApp,
-			derived: input.derived,
-			source: input.source
-		}) : /* @__PURE__ */ jsx(PublishedPageExperience, { source: input.source });
+			derived: input.derived
+		}) : /* @__PURE__ */ jsx(CuratedPageContent, {});
 		$[7] = camoxApp;
-		$[8] = input.derived;
-		$[9] = input.routeKind;
-		$[10] = input.source;
-		$[11] = t3;
-	} else t3 = $[11];
-	const published = t3;
-	let t4;
-	if ($[12] !== published) {
-		t4 = /* @__PURE__ */ jsx(Frame, { children: published });
-		$[12] = published;
-		$[13] = t4;
-	} else t4 = $[13];
-	const isolatedPage = t4;
-	const fallback = input.routeKind ? published : isolatedPage;
+		$[8] = input.canvasOnly;
+		$[9] = input.derived;
+		$[10] = input.routeKind;
+		$[11] = t4;
+	} else t4 = $[11];
+	const readOnlyPage = t4;
+	let t5;
+	if ($[12] !== readOnlyPage) {
+		t5 = /* @__PURE__ */ jsx(Frame, { children: readOnlyPage });
+		$[12] = readOnlyPage;
+		$[13] = t5;
+	} else t5 = $[13];
+	const isolatedPage = t5;
+	let t6;
+	if ($[14] !== input.routeKind || $[15] !== isolatedPage) {
+		t6 = input.routeKind ? /* @__PURE__ */ jsx(StudioLoadError, {}) : isolatedPage;
+		$[14] = input.routeKind;
+		$[15] = isolatedPage;
+		$[16] = t6;
+	} else t6 = $[16];
+	const fallback = t6;
 	if (isAuthenticated) {
-		let t5;
-		if ($[14] !== camoxApp || $[15] !== hasHydrated || $[16] !== input || $[17] !== queryClient) {
-			t5 = hasHydrated ? /* @__PURE__ */ jsx(LazyEditablePageExperience, {
+		let t7;
+		if ($[17] !== camoxApp || $[18] !== hasHydrated || $[19] !== input || $[20] !== queryClient) {
+			t7 = hasHydrated ? /* @__PURE__ */ jsx(AllBlocks, {
 				camoxApp,
-				input,
-				queryClient
+				children: /* @__PURE__ */ jsx(LazyEditablePageExperience, {
+					camoxApp,
+					input,
+					queryClient
+				})
 			}) : null;
-			$[14] = camoxApp;
-			$[15] = hasHydrated;
-			$[16] = input;
-			$[17] = queryClient;
-			$[18] = t5;
-		} else t5 = $[18];
-		const editor = t5;
-		let t6;
-		if ($[19] !== editor || $[20] !== fallback || $[21] !== input.previewDocument || $[22] !== input.routeKind || $[23] !== published) {
-			t6 = input.routeKind ? /* @__PURE__ */ jsx(React.Suspense, {
-				fallback,
-				children: editor ?? fallback
+			$[17] = camoxApp;
+			$[18] = hasHydrated;
+			$[19] = input;
+			$[20] = queryClient;
+			$[21] = t7;
+		} else t7 = $[21];
+		const editor = t7;
+		const t8 = input.routeKind ? loading : isolatedPage;
+		let t9;
+		if ($[22] !== editor || $[23] !== input.derived || $[24] !== input.previewDocument || $[25] !== input.routeKind || $[26] !== readOnlyPage) {
+			t9 = input.routeKind ? /* @__PURE__ */ jsx(React.Suspense, {
+				fallback: loading,
+				children: editor ?? loading
 			}) : /* @__PURE__ */ jsx(PreviewActivation, {
-				fallback: /* @__PURE__ */ jsx(Frame, {
-					serverOnly: !!input.previewDocument,
-					children: published
+				fallback: /* @__PURE__ */ jsx(EditingFallbackSlot, {
+					layoutPage: !!input.derived,
+					children: /* @__PURE__ */ jsx(Frame, {
+						serverOnly: !!input.previewDocument,
+						children: readOnlyPage
+					})
 				}),
 				children: editor
 			});
-			$[19] = editor;
-			$[20] = fallback;
-			$[21] = input.previewDocument;
-			$[22] = input.routeKind;
-			$[23] = published;
-			$[24] = t6;
-		} else t6 = $[24];
-		let t7;
-		if ($[25] !== fallback || $[26] !== t6) {
-			t7 = /* @__PURE__ */ jsx(EditingActivationBoundary, {
+			$[22] = editor;
+			$[23] = input.derived;
+			$[24] = input.previewDocument;
+			$[25] = input.routeKind;
+			$[26] = readOnlyPage;
+			$[27] = t9;
+		} else t9 = $[27];
+		let t10;
+		if ($[28] !== fallback || $[29] !== t9) {
+			t10 = /* @__PURE__ */ jsx(EditingActivationBoundary, {
 				fallback,
-				children: t6
+				children: t9
 			});
-			$[25] = fallback;
-			$[26] = t6;
-			$[27] = t7;
-		} else t7 = $[27];
-		let t8;
-		if ($[28] !== input || $[29] !== t7) {
-			t8 = /* @__PURE__ */ jsx(RuntimeChrome, {
+			$[28] = fallback;
+			$[29] = t9;
+			$[30] = t10;
+		} else t10 = $[30];
+		let t11;
+		if ($[31] !== input || $[32] !== t10 || $[33] !== t8) {
+			t11 = /* @__PURE__ */ jsx(RuntimeChromeSlot, {
 				input,
-				children: t7
+				fallback: t8,
+				children: t10
 			});
-			$[28] = input;
-			$[29] = t7;
-			$[30] = t8;
-		} else t8 = $[30];
-		return t8;
+			$[31] = input;
+			$[32] = t10;
+			$[33] = t8;
+			$[34] = t11;
+		} else t11 = $[34];
+		return t11;
 	}
-	if (input.routeKind) return null;
+	if (studioOnly) return null;
 	if (hasHydrated && isLocalhostPreview()) {
-		let t5;
-		if ($[31] !== published) {
-			t5 = /* @__PURE__ */ jsx(LazyLocalhostPreviewProvider, { children: published });
-			$[31] = published;
-			$[32] = t5;
-		} else t5 = $[32];
-		let t6;
-		if ($[33] !== published || $[34] !== t5) {
-			t6 = /* @__PURE__ */ jsx(React.Suspense, {
-				fallback: published,
-				children: t5
+		let t7;
+		if ($[35] !== readOnlyPage) {
+			t7 = /* @__PURE__ */ jsx(LazyLocalhostPreviewProvider, { children: readOnlyPage });
+			$[35] = readOnlyPage;
+			$[36] = t7;
+		} else t7 = $[36];
+		let t8;
+		if ($[37] !== camoxApp || $[38] !== t7) {
+			t8 = /* @__PURE__ */ jsx(AllBlocks, {
+				camoxApp,
+				children: t7
+			});
+			$[37] = camoxApp;
+			$[38] = t7;
+			$[39] = t8;
+		} else t8 = $[39];
+		let t9;
+		if ($[40] !== readOnlyPage || $[41] !== t8) {
+			t9 = /* @__PURE__ */ jsx(React.Suspense, {
+				fallback: readOnlyPage,
+				children: t8
 			});
-			$[33] = published;
-			$[34] = t5;
-			$[35] = t6;
-		} else t6 = $[35];
-		return t6;
+			$[40] = readOnlyPage;
+			$[41] = t8;
+			$[42] = t9;
+		} else t9 = $[42];
+		return t9;
 	}
 	if (studioDocument) {
-		let t5;
-		if ($[36] === Symbol.for("react.memo_cache_sentinel")) {
-			t5 = { height: "100vh" };
-			$[36] = t5;
-		} else t5 = $[36];
-		let t6;
-		if ($[37] !== isolatedPage) {
-			t6 = /* @__PURE__ */ jsx("div", {
-				style: t5,
+		let t7;
+		if ($[43] === Symbol.for("react.memo_cache_sentinel")) {
+			t7 = { height: "100vh" };
+			$[43] = t7;
+		} else t7 = $[43];
+		let t8;
+		if ($[44] !== isolatedPage) {
+			t8 = /* @__PURE__ */ jsx("div", {
+				style: t7,
 				children: isolatedPage
 			});
-			$[37] = isolatedPage;
-			$[38] = t6;
-		} else t6 = $[38];
-		return t6;
+			$[44] = isolatedPage;
+			$[45] = t8;
+		} else t8 = $[45];
+		return t8;
 	}
-	return published;
+	return readOnlyPage;
 }
 function _temp2() {
 	return false;
@@ -258,6 +302,37 @@ function _temp2() {
 function _temp() {
 	return true;
 }
+function StudioLoadError() {
+	const $ = c(1);
+	let t0;
+	if ($[0] === Symbol.for("react.memo_cache_sentinel")) {
+		t0 = /* @__PURE__ */ jsxs("div", {
+			role: "alert",
+			className: "flex flex-1 flex-col items-start justify-center gap-3 p-6",
+			children: [
+				/* @__PURE__ */ jsx("h1", {
+					className: "text-lg font-semibold",
+					children: "Studio failed to load"
+				}),
+				/* @__PURE__ */ jsx("p", {
+					className: "text-muted-foreground text-sm",
+					children: "Something went wrong while opening Studio. Reload the page to try again."
+				}),
+				/* @__PURE__ */ jsx("button", {
+					type: "button",
+					className: "bg-accent text-accent-foreground rounded-md px-3 py-1.5 text-sm font-medium",
+					onClick: _temp3,
+					children: "Reload Studio"
+				})
+			]
+		});
+		$[0] = t0;
+	} else t0 = $[0];
+	return t0;
+}
+function _temp3() {
+	return window.location.reload();
+}
 
 //#endregion
 export { PageApp };

package/dist/features/runtime/pageBlockTypes.js

@@ -0,0 +1,20 @@
+import { reads } from "../../lib/studio-reads.js";
+
+//#region src/features/runtime/pageBlockTypes.ts
+/**
+* The block definitions a render input's blocks use. Every block a page or layout renders
+* is seeded as a block query, so its dehydrated state names them all.
+*/
+function getPageBlockTypes(dehydratedState) {
+	if (!dehydratedState || typeof dehydratedState !== "object" || !("queries" in dehydratedState) || !Array.isArray(dehydratedState.queries)) return [];
+	const types = /* @__PURE__ */ new Set();
+	for (const query of dehydratedState.queries) {
+		if (!query.queryKey || reads.blockBundle.paramsOf(query.queryKey) === null) continue;
+		const type = query.state?.data?.block?.type;
+		if (typeof type === "string") types.add(type);
+	}
+	return [...types];
+}
+
+//#endregion
+export { getPageBlockTypes };

package/dist/features/runtime/pageClient.d.ts

@@ -1,6 +1,4 @@
 import { CamoxApp } from "../../core/createApp.js";
-
 //#region src/features/runtime/pageClient.d.ts
-declare function hydratePageWithApp(camoxApp: CamoxApp): void;
-//#endregion
-export { hydratePageWithApp };
+export declare function hydratePageWithApp(camoxApp: CamoxApp): Promise<void>;
+//#endregion