camox 0.44.0 → 0.45.0

package/dist/features/runtime/RuntimeChrome.js

@@ -1,148 +1,150 @@
-import { getApiClient } from "../../lib/api-client.js";
-import { SharedChromeContext } from "./SharedChromeContext.js";
-import { previewStore, selectPreviewSource } from "../preview/previewStore.js";
+import { previewStore, selectIsCanvasShown } from "../preview/previewStore.js";
+import { shownRecordPage } from "../preview/pageRecord.js";
 import { Navbar } from "../studio/components/Navbar.js";
 import { PreviewToolbar } from "../preview/components/PreviewToolbar.js";
+import { EditingFallbackContext } from "./editingFallback.js";
+import { StudioEditingFallback } from "../preview/components/StudioEditingFallback.js";
+import { ChatSidebar } from "../studio/components/ChatSidebar.js";
+import { FollowAgentProvider } from "../studio/FollowAgentProvider.js";
 import { c } from "react/compiler-runtime";
-import { useQuery } from "@tanstack/react-query";
-import { jsx, jsxs } from "react/jsx-runtime";
 import { useSelector } from "@xstate/store-react";
-import { queryKeys } from "@camox/api-contract/query-keys";
+import { jsx, jsxs } from "react/jsx-runtime";
 import studioCssUrl from "virtual:camox-studio-css";
 
 //#region src/features/runtime/RuntimeChrome.tsx
+const renderEditingFallback = ({ layoutPage, children }) => /* @__PURE__ */ jsx(StudioEditingFallback, {
+	layoutPage,
+	children
+});
 function RuntimeChrome(t0) {
-	const $ = c(34);
-	if ($[0] !== "4f2448cdd08f7a2c7703fe11bfa7e45ebc2f0485d14029a9a68ae33e62958b54") {
-		for (let $i = 0; $i < 34; $i += 1) $[$i] = Symbol.for("react.memo_cache_sentinel");
-		$[0] = "4f2448cdd08f7a2c7703fe11bfa7e45ebc2f0485d14029a9a68ae33e62958b54";
-	}
+	const $ = c(32);
 	const { input, children } = t0;
-	const preview = !input.routeKind;
+	const website = !input.routeKind;
 	const hidden = useSelector(previewStore, _temp);
-	const source = useSelector(previewStore, selectPreviewSource);
-	let t1;
-	if ($[1] !== input.pathname || $[2] !== source) {
-		t1 = queryKeys.pages.getByPath(input.pathname, source);
-		$[1] = input.pathname;
-		$[2] = source;
-		$[3] = t1;
-	} else t1 = $[3];
+	const isCanvasShown = useSelector(previewStore, selectIsCanvasShown);
+	const showChat = !website || isCanvasShown;
+	const t1 = input.runtimeBasePath;
 	let t2;
-	if ($[4] !== input.pathname || $[5] !== input.projectSlug || $[6] !== source) {
-		t2 = () => getApiClient().pages.getStructure({
-			path: input.pathname,
-			projectSlug: input.projectSlug,
-			source
-		});
-		$[4] = input.pathname;
-		$[5] = input.projectSlug;
-		$[6] = source;
-		$[7] = t2;
-	} else t2 = $[7];
-	let t3;
-	if ($[8] !== t1 || $[9] !== t2) {
-		t3 = {
-			queryKey: t1,
-			queryFn: t2,
-			enabled: false
-		};
-		$[8] = t1;
-		$[9] = t2;
-		$[10] = t3;
-	} else t3 = $[10];
-	const { data: page } = useQuery(t3);
-	let t4;
-	if ($[11] === Symbol.for("react.memo_cache_sentinel")) {
-		t4 = /* @__PURE__ */ jsx("link", {
+	if ($[0] === Symbol.for("react.memo_cache_sentinel")) {
+		t2 = /* @__PURE__ */ jsx("link", {
 			rel: "stylesheet",
 			href: studioCssUrl,
 			"data-camox-studio": true
 		});
-		$[11] = t4;
-	} else t4 = $[11];
-	const t5 = preview ? "max-md:hidden" : void 0;
-	const t6 = preview && hidden;
+		$[0] = t2;
+	} else t2 = $[0];
+	const t3 = website ? "max-md:hidden" : void 0;
+	const t4 = website && hidden;
+	let t5;
+	if ($[1] !== input) {
+		t5 = shownRecordPage(input);
+		$[1] = input;
+		$[2] = t5;
+	} else t5 = $[2];
+	let t6;
+	if ($[3] !== t5 || $[4] !== website) {
+		t6 = /* @__PURE__ */ jsx(Navbar, {
+			isWebsite: website,
+			recordPage: t5
+		});
+		$[3] = t5;
+		$[4] = website;
+		$[5] = t6;
+	} else t6 = $[5];
 	let t7;
-	if ($[12] !== preview) {
-		t7 = /* @__PURE__ */ jsx(Navbar, { isPreview: preview });
-		$[12] = preview;
-		$[13] = t7;
-	} else t7 = $[13];
-	let t8;
-	if ($[14] !== t5 || $[15] !== t6 || $[16] !== t7) {
-		t8 = /* @__PURE__ */ jsx("div", {
-			className: t5,
-			hidden: t6,
-			children: t7
+	if ($[6] !== t3 || $[7] !== t4 || $[8] !== t6) {
+		t7 = /* @__PURE__ */ jsx("div", {
+			className: t3,
+			hidden: t4,
+			children: t6
 		});
-		$[14] = t5;
-		$[15] = t6;
-		$[16] = t7;
-		$[17] = t8;
-	} else t8 = $[17];
+		$[6] = t3;
+		$[7] = t4;
+		$[8] = t6;
+		$[9] = t7;
+	} else t7 = $[9];
+	const t8 = input.canvasOnly ? null : renderEditingFallback;
 	let t9;
-	if ($[18] !== children) {
+	if ($[10] !== children || $[11] !== t8) {
 		t9 = /* @__PURE__ */ jsx("div", {
 			className: "flex min-h-0 flex-1 flex-col overflow-auto",
-			children
+			children: /* @__PURE__ */ jsx(EditingFallbackContext, {
+				value: t8,
+				children
+			})
 		});
-		$[18] = children;
-		$[19] = t9;
-	} else t9 = $[19];
-	const t10 = !preview;
+		$[10] = children;
+		$[11] = t8;
+		$[12] = t9;
+	} else t9 = $[12];
+	const t10 = !website;
 	const t11 = input.derived ? void 0 : "max-md:hidden";
-	const t12 = page?.page.id;
-	const t13 = preview && !input.derived ? page?.page.status : void 0;
-	const t14 = !!page?.page.livePublishedCheckpointId;
-	let t15;
-	if ($[20] !== t12 || $[21] !== t13 || $[22] !== t14) {
-		t15 = /* @__PURE__ */ jsx(PreviewToolbar, {
-			pageId: t12,
-			pageStatus: t13,
-			hasLiveVersion: t14
-		});
-		$[20] = t12;
-		$[21] = t13;
-		$[22] = t14;
-		$[23] = t15;
-	} else t15 = $[23];
-	let t16;
-	if ($[24] !== t10 || $[25] !== t11 || $[26] !== t15) {
-		t16 = /* @__PURE__ */ jsx("div", {
+	let t12;
+	if ($[13] === Symbol.for("react.memo_cache_sentinel")) {
+		t12 = /* @__PURE__ */ jsx(PreviewToolbar, {});
+		$[13] = t12;
+	} else t12 = $[13];
+	let t13;
+	if ($[14] !== t10 || $[15] !== t11) {
+		t13 = /* @__PURE__ */ jsx("div", {
 			hidden: t10,
 			className: t11,
-			children: t15
+			children: t12
+		});
+		$[14] = t10;
+		$[15] = t11;
+		$[16] = t13;
+	} else t13 = $[16];
+	let t14;
+	if ($[17] !== t13 || $[18] !== t9) {
+		t14 = /* @__PURE__ */ jsxs("div", {
+			className: "relative flex min-h-0 min-w-0 flex-1 flex-col",
+			children: [t9, t13]
 		});
-		$[24] = t10;
-		$[25] = t11;
-		$[26] = t15;
-		$[27] = t16;
-	} else t16 = $[27];
+		$[17] = t13;
+		$[18] = t9;
+		$[19] = t14;
+	} else t14 = $[19];
+	const t15 = !showChat;
+	let t16;
+	if ($[20] !== t15) {
+		t16 = /* @__PURE__ */ jsx(ChatSidebar, { hidden: t15 });
+		$[20] = t15;
+		$[21] = t16;
+	} else t16 = $[21];
 	let t17;
-	if ($[28] !== t16 || $[29] !== t9) {
+	if ($[22] !== t14 || $[23] !== t16) {
 		t17 = /* @__PURE__ */ jsxs("div", {
-			className: "relative flex min-h-0 flex-1 flex-col",
-			children: [t9, t16]
+			className: "flex min-h-0 flex-1",
+			children: [t14, t16]
 		});
-		$[28] = t16;
-		$[29] = t9;
-		$[30] = t17;
-	} else t17 = $[30];
+		$[22] = t14;
+		$[23] = t16;
+		$[24] = t17;
+	} else t17 = $[24];
 	let t18;
-	if ($[31] !== t17 || $[32] !== t8) {
-		t18 = /* @__PURE__ */ jsxs(SharedChromeContext.Provider, {
-			value: true,
-			children: [t4, /* @__PURE__ */ jsxs("div", {
-				className: "bg-background flex h-screen flex-col overflow-hidden",
-				children: [t8, t17]
-			})]
+	if ($[25] !== t17 || $[26] !== t7) {
+		t18 = /* @__PURE__ */ jsxs("div", {
+			className: "bg-background flex h-screen flex-col overflow-hidden",
+			children: [t7, t17]
+		});
+		$[25] = t17;
+		$[26] = t7;
+		$[27] = t18;
+	} else t18 = $[27];
+	let t19;
+	if ($[28] !== input.runtimeBasePath || $[29] !== t18 || $[30] !== website) {
+		t19 = /* @__PURE__ */ jsxs(FollowAgentProvider, {
+			runtimeBasePath: t1,
+			website,
+			children: [t2, t18]
 		});
-		$[31] = t17;
-		$[32] = t8;
-		$[33] = t18;
-	} else t18 = $[33];
-	return t18;
+		$[28] = input.runtimeBasePath;
+		$[29] = t18;
+		$[30] = website;
+		$[31] = t19;
+	} else t19 = $[31];
+	return t19;
 }
 function _temp(state) {
 	return state.context.isToolbarHidden;

package/dist/features/runtime/alternates.js

@@ -0,0 +1,64 @@
+import { localizedPath } from "../../lib/locale-path.js";
+import { getPageDestinations } from "../../core/pageDestinations.js";
+import { discoverLayoutPages } from "../../core/derivedRoutes.js";
+
+//#region src/features/runtime/alternates.ts
+/**
+* The locales a page exists in, in the order of the scope's locales, with its path in each.
+* `located` is where the render found it. A locale that can't be read leaves the page out of it
+* rather than failing the render.
+*/
+async function findAlternates({ identity, located: { locale, locales, path }, layouts, reads }) {
+	const pathIn = async (other) => {
+		if (other.tag === locale.tag) return path;
+		if (identity.kind === "code-owned") return path;
+		if (identity.kind === "curated") return getPageDestinations(await reads.pages(other), layouts).find((destination) => destination.key === `page:${identity.pageId}`)?.fullPath;
+		return (await discoverLayoutPages(identity.layout, reads.context(other))).find((page) => page.recordId === identity.recordId)?.path;
+	};
+	return (await Promise.all(locales.map(async (other) => {
+		try {
+			const otherPath = await pathIn(other);
+			return otherPath === void 0 ? void 0 : {
+				locale: other.tag,
+				path: localizedPath(otherPath, other)
+			};
+		} catch (error) {
+			console.error(`[camox] Couldn't find the page's alternate in "${other.tag}".`, error);
+			return;
+		}
+	}))).filter((alternate) => alternate !== void 0);
+}
+/** Each page's alternates by its key, from the pages of every locale. */
+function alternatesByPage(localizations) {
+	const alternates = /* @__PURE__ */ new Map();
+	for (const { locale, pages } of localizations) for (const { key, fullPath } of pages) {
+		const found = alternates.get(key) ?? [];
+		found.push({
+			locale: locale.tag,
+			path: localizedPath(fullPath, locale)
+		});
+		alternates.set(key, found);
+	}
+	return alternates;
+}
+/**
+* The `hreflang` links of a page's alternates, plus `x-default` for the default locale's page
+* when it exists. None for a project with a single locale: there is nothing to tell apart.
+*/
+function hreflangLinks(alternates, locales, url) {
+	if (locales.length < 2) return [];
+	const links = alternates.map(({ locale, path }) => ({
+		hreflang: locale,
+		href: url(path)
+	}));
+	const defaultTag = locales.find((locale) => locale.isDefault)?.tag;
+	const fallback = alternates.find(({ locale }) => locale === defaultTag);
+	if (fallback) links.push({
+		hreflang: "x-default",
+		href: url(fallback.path)
+	});
+	return links;
+}
+
+//#endregion
+export { alternatesByPage, findAlternates, hreflangLinks };

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

@@ -0,0 +1,7 @@
+import { PageStructure } from "../routes/pageRuntime.js";
+//#region src/features/runtime/analytics.d.ts
+/**
+ * The project's analytics providers, a Project Setting. Each provider is null when it isn't set up.
+ */
+export type AnalyticsProviders = PageStructure["project"]["analytics"];
+//#endregion

package/dist/features/runtime/analytics.js

@@ -0,0 +1,66 @@
+import { escapeAttribute, serializeJsonForHtml } from "../../lib/html.js";
+
+//#region src/features/runtime/analytics.ts
+/** `providers`, when at least one is set up. */
+function configuredProviders(providers) {
+	return providers && PROVIDERS.some((provider) => providers[provider]) ? providers : void 0;
+}
+/**
+* PostHog's standard snippet: it defines a `posthog` global that queues calls, and loads the SDK
+* from the host passed to `init` without blocking the page.
+*/
+const POSTHOG_SNIPPET = `!function(t,e){var o,n,p,r;e.__SV||(window.posthog && window.posthog.__loaded)||(window.posthog=e,e._i=[],e.init=function(i,s,a){function g(t,e){var o=e.split(".");2==o.length&&(t=t[o[0]],e=o[1]),t[e]=function(){t.push([e].concat(Array.prototype.slice.call(arguments,0)))}}p||((p=t.createElement("script")).type="text/javascript",p.crossOrigin="anonymous",p.async=!0,p.src=s.api_host.replace(".i.posthog.com","-assets.i.posthog.com")+"/static/array.js",p.onerror=function(){p=null},(r=t.getElementsByTagName("script")[0]).parentNode.insertBefore(p,r));var u=e;for(void 0!==a?u=e[a]=[]:a="posthog",u.people=u.people||[],Object.defineProperty(u,"toString",{configurable:!0,enumerable:!0,writable:!0,value:function(t){var e="posthog";return"posthog"!==a&&(e+="."+a),t||(e+=" (stub)"),e}}),Object.defineProperty(u.people,"toString",{configurable:!0,enumerable:!0,writable:!0,value:function(){return u.toString(1)+".people (stub)"}}),o="init capture register register_once register_for_session unregister unregister_for_session getFeatureFlag getFeatureFlagResult isFeatureEnabled reloadFeatureFlags updateEarlyAccessFeatureEnrollment getEarlyAccessFeatures on onFeatureFlags onSessionId getSurveys getActiveMatchingSurveys renderSurvey canRenderSurvey getNextSurveyStep identify setPersonProperties group resetGroups setPersonPropertiesForFlags resetPersonPropertiesForFlags setGroupPropertiesForFlags resetGroupPropertiesForFlags reset get_distinct_id getGroups get_session_id get_session_replay_url alias set_config startSessionRecording stopSessionRecording sessionRecordingStarted captureException loadToolbar get_property getSessionProperty createPersonProfile opt_in_capturing opt_out_capturing has_opted_in_capturing has_opted_out_capturing clear_opt_in_out_capturing debug".split(" "),n=0;n<o.length;n++)g(u,o[n]);e._i.push([i,s,a])},e.__SV=1)}(document,window.posthog||[]);`;
+/** The scripts that load each provider, with automatic page views off. */
+const providerScripts = {
+	ga4: ({ measurementId }) => {
+		const src = `https://www.googletagmanager.com/gtag/js?id=${encodeURIComponent(measurementId)}`;
+		return `<script async src="${escapeAttribute(src)}"><\/script><script>window.dataLayer=window.dataLayer||[];function gtag(){dataLayer.push(arguments);}gtag("js",new Date());gtag("config",${serializeJsonForHtml(measurementId)},{send_page_view:false});<\/script>`;
+	},
+	posthog: ({ projectApiKey, region }) => {
+		const config = {
+			api_host: `https://${region}.i.posthog.com`,
+			defaults: "2026-05-30",
+			capture_pageview: false,
+			capture_pageleave: true
+		};
+		return `<script>${POSTHOG_SNIPPET}posthog.init(${serializeJsonForHtml(projectApiKey)},${serializeJsonForHtml(config)});<\/script>`;
+	}
+};
+const PROVIDERS = Object.keys(providerScripts);
+/** The script loading `provider` with its `settings`, or nothing when it isn't set up. */
+function providerScript(provider, settings) {
+	return settings ? providerScripts[provider](settings) : "";
+}
+/**
+* The providers' scripts, loaded without blocking the page. They send no page view of their own:
+* the page client does, once each page's title is in place.
+*/
+function renderAnalyticsScripts(providers) {
+	if (!providers) return "";
+	return PROVIDERS.map((provider) => providerScript(provider, providers[provider])).join("");
+}
+/** How each provider receives a page view, through the global its script defines. */
+const pageViewSenders = {
+	ga4: ({ url, path, title }, target) => target.gtag?.("event", "page_view", {
+		page_location: url,
+		page_path: path,
+		page_title: title
+	}),
+	posthog: ({ url, path, title }, target) => target.posthog?.capture("$pageview", {
+		$current_url: url,
+		$pathname: path,
+		title
+	})
+};
+/** Sends a page view of the page `target` shows to every provider the server loaded. */
+function sendPageView(providers, target) {
+	const pageView = {
+		url: target.location.href,
+		path: target.location.pathname,
+		title: target.document.title
+	};
+	for (const provider of PROVIDERS) if (providers[provider]) pageViewSenders[provider](pageView, target);
+}
+
+//#endregion
+export { configuredProviders, renderAnalyticsScripts, sendPageView };

package/dist/features/runtime/artifactSources.js

@@ -0,0 +1,87 @@
+import { artifactSourceOf } from "../../core/lib/artifact.js";
+
+//#region src/features/runtime/artifactSources.ts
+/**
+* A page's HTML holds each rendered artifact source in its frame's `srcdoc`, so the server leaves
+* them out of the hydration data, and the client takes them back from the frames before
+* hydrating. Each source left out becomes a reference to it, made of this prefix and a key.
+*/
+const REFERENCE = "\0camox-artifact-source:";
+/**
+* The HTML parser turns every CR LF and lone CR into LF, attribute values included, so sources
+* are keyed with LF only.
+*/
+const normalizeNewlines = (value) => value.replace(/\r\n?/g, "\n");
+/** A key that tells a source apart from the others on its page: its length and FNV-1a hash. */
+function referenceTo(source) {
+	let hash = 2166136261;
+	for (let index = 0; index < source.length; index++) {
+		hash ^= source.charCodeAt(index);
+		hash = Math.imul(hash, 16777619);
+	}
+	return `${REFERENCE}${source.length}:${(hash >>> 0).toString(36)}`;
+}
+function isPlainObject(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const prototype = Object.getPrototypeOf(value);
+	return prototype === Object.prototype || prototype === null;
+}
+/** A copy of a JSON value with every string replaced. */
+function mapStrings(value, replace) {
+	if (typeof value === "string") return replace(value);
+	if (Array.isArray(value)) return value.map((item) => mapStrings(item, replace));
+	if (!isPlainObject(value)) return value;
+	return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, mapStrings(item, replace)]));
+}
+const ENTITIES = {
+	amp: "&",
+	lt: "<",
+	gt: ">",
+	quot: "\"",
+	apos: "'"
+};
+function decodeAttribute(value) {
+	return value.replace(/&(#x[0-9a-f]+|#\d+|[a-z]+);/gi, (entity, name) => {
+		if (name[0] !== "#") return ENTITIES[name.toLowerCase()] ?? entity;
+		const code = name[1] === "x" || name[1] === "X" ? parseInt(name.slice(2), 16) : Number(name.slice(1));
+		return String.fromCodePoint(code);
+	});
+}
+/**
+* The page's dehydrated state without the artifact sources its HTML already holds in frames,
+* each replaced by a reference. Sources the HTML doesn't render stay, as the client couldn't
+* take them back.
+*/
+function omitArtifactSources(dehydratedState, html) {
+	const rendered = /* @__PURE__ */ new Set();
+	for (const [, srcdoc] of html.matchAll(/<iframe\b[^>]*?\ssrcdoc="([^"]*)"/gi)) {
+		const source = artifactSourceOf(normalizeNewlines(decodeAttribute(srcdoc)));
+		if (source) rendered.add(source);
+	}
+	if (rendered.size === 0) return dehydratedState;
+	return mapStrings(dehydratedState, (value) => {
+		const source = normalizeNewlines(value);
+		return rendered.has(source) ? referenceTo(source) : value;
+	});
+}
+/**
+* The dehydrated state with the artifact sources that `omitArtifactSources` left out taken back
+* from the frames under `root`, as the browser parsed them, so they hydrate the frames unchanged.
+*/
+function restoreArtifactSources(dehydratedState, root) {
+	const sources = /* @__PURE__ */ new Map();
+	for (const frame of root.querySelectorAll("iframe[srcdoc]")) {
+		const source = artifactSourceOf(frame.getAttribute("srcdoc") ?? "");
+		if (source) sources.set(referenceTo(normalizeNewlines(source)), source);
+	}
+	return mapStrings(dehydratedState, (value) => {
+		if (!value.startsWith(REFERENCE)) return value;
+		const source = sources.get(value);
+		if (source !== void 0) return source;
+		console.error("Camox: an artifact's frame was missing from the page before hydration.");
+		return "";
+	});
+}
+
+//#endregion
+export { omitArtifactSources, restoreArtifactSources };

package/dist/features/runtime/editingFallback.js

@@ -0,0 +1,20 @@
+import * as React from "react";
+
+//#region src/features/runtime/editingFallback.tsx
+/**
+* Renders the read-only page while the editor is still loading. The Studio
+* chrome provides it, so visitors never download it.
+*/
+const EditingFallbackContext = React.createContext(null);
+/** The read-only page shown until the editor activates, laid out for the Canvas when it shows. */
+function EditingFallbackSlot({ layoutPage, children }) {
+	const render = React.use(EditingFallbackContext);
+	if (!render) return children;
+	return render({
+		layoutPage,
+		children
+	});
+}
+
+//#endregion
+export { EditingFallbackContext, EditingFallbackSlot };

package/dist/features/runtime/linkPrefetch.js

@@ -0,0 +1,97 @@
+//#region src/features/runtime/linkPrefetch.ts
+/**
+* Loads a page before its link is followed: when the pointer rests on the link, when the link is
+* focused, or when a finger touches it. The next navigation to that page uses what was loaded.
+*/
+/** How long the pointer rests on a link before its page loads, so sweeping across links doesn't. */
+const HOVER_INTENT_DELAY = 50;
+/** How long a loaded page may serve a navigation. Later, the navigation reads it afresh. */
+const PREFETCH_STALE_TIME = 3e4;
+function createPrefetchCache({ staleTime = PREFETCH_STALE_TIME, now = Date.now } = {}) {
+	const entries = /* @__PURE__ */ new Map();
+	const fresh = (key) => {
+		const entry = entries.get(key);
+		if (entry && now() - entry.loadedAt < staleTime) return entry;
+		entries.delete(key);
+	};
+	return {
+		/** Starts `load`ing `key`, unless a fresh load of it is already there or under way. */
+		prefetch(key, load) {
+			if (fresh(key)) return;
+			const entry = {
+				promise: load(),
+				loadedAt: now()
+			};
+			entries.set(key, entry);
+			entry.promise.catch(() => {
+				if (entries.get(key) === entry) entries.delete(key);
+			});
+		},
+		/** The fresh load of `key`, which then no longer serves later navigations. */
+		take(key) {
+			const entry = fresh(key);
+			entries.delete(key);
+			return entry?.promise;
+		},
+		clear() {
+			entries.clear();
+		}
+	};
+}
+/** Whether the visitor asked to save data, or is on a connection too slow to spend on guesses. */
+function savesData(win) {
+	const connection = win.navigator.connection;
+	return !!connection?.saveData || /(^|-)2g$/.test(connection?.effectiveType ?? "");
+}
+/**
+* Calls `onIntent` with each link the visitor is about to follow. `doc` delegates for every link,
+* including ones rendered later.
+*/
+function listenForLinkIntent(doc, onIntent, { hoverDelay = 50 } = {}) {
+	const win = doc.defaultView;
+	let hovered = null;
+	const anchorOf = (target) => target instanceof win.Element ? target.closest("a") : null;
+	const intent = (anchor) => {
+		if (!anchor.href || savesData(win)) return;
+		onIntent(anchor);
+	};
+	const cancelHover = () => {
+		if (hovered) clearTimeout(hovered.timer);
+		hovered = null;
+	};
+	const onMouseOver = (event) => {
+		const anchor = anchorOf(event.target);
+		if (!anchor || hovered?.anchor === anchor) return;
+		cancelHover();
+		hovered = {
+			anchor,
+			timer: setTimeout(() => intent(anchor), hoverDelay)
+		};
+	};
+	const onMouseOut = (event) => {
+		if (!hovered || hovered.anchor.contains(event.relatedTarget)) return;
+		if (anchorOf(event.target) === hovered.anchor) cancelHover();
+	};
+	const onFocusIn = (event) => {
+		const anchor = anchorOf(event.target);
+		if (anchor) intent(anchor);
+	};
+	const onTouchStart = (event) => {
+		const anchor = anchorOf(event.target);
+		if (anchor) intent(anchor);
+	};
+	doc.addEventListener("mouseover", onMouseOver);
+	doc.addEventListener("mouseout", onMouseOut);
+	doc.addEventListener("focusin", onFocusIn);
+	doc.addEventListener("touchstart", onTouchStart, { passive: true });
+	return () => {
+		cancelHover();
+		doc.removeEventListener("mouseover", onMouseOver);
+		doc.removeEventListener("mouseout", onMouseOut);
+		doc.removeEventListener("focusin", onFocusIn);
+		doc.removeEventListener("touchstart", onTouchStart);
+	};
+}
+
+//#endregion
+export { PREFETCH_STALE_TIME, createPrefetchCache, listenForLinkIntent };

package/dist/features/runtime/livePages.js

@@ -0,0 +1,62 @@
+import { createRequestContext } from "../../core/requestContext.js";
+import { getPageDestinations } from "../../core/pageDestinations.js";
+import { discoverLayoutPages } from "../../core/derivedRoutes.js";
+
+//#region src/features/runtime/livePages.ts
+/**
+* The pages served on Live: curated pages and singletons (without pages missing their layout or
+* shadowed by a singleton), then the pages derived layouts discover. `records` must read Live.
+* Rejects when a layout's Route Discovery fails: an index silently missing pages is worse.
+*/
+async function listLivePages({ pages, app, records }) {
+	const layouts = app?.getLayouts() ?? [];
+	const pagesById = new Map(pages.map((page) => [page.id, page]));
+	const destinations = getPageDestinations(pages, layouts).map((destination) => {
+		if (destination.kind === "singleton") {
+			const layout = layouts.find(({ _internal }) => _internal.id === destination.layoutId);
+			return {
+				key: destination.key,
+				fullPath: destination.fullPath,
+				layoutId: destination.layoutId,
+				title: layout._internal.title,
+				hasMarkdown: servesMarkdown(layout)
+			};
+		}
+		const page = pagesById.get(destination.pageId);
+		return {
+			key: destination.key,
+			fullPath: page.fullPath,
+			layoutId: page.layoutId,
+			title: page.metaTitle || page.nickname,
+			...page.metaDescription && { description: page.metaDescription },
+			hasMarkdown: true,
+			updatedAt: page.updatedAt
+		};
+	});
+	const context = createRequestContext({ records });
+	const discovered = await Promise.all(layouts.filter((layout) => layout._internal.kind === "derived").map(async (layout) => {
+		return (await discoverLayoutPages(layout, context).catch((error) => {
+			throw new RouteDiscoveryError(error);
+		})).map((page) => ({
+			key: page.recordId ? `record:${layout._internal.id}:${page.recordId}` : `derived:${page.path}`,
+			fullPath: page.path,
+			layoutId: layout._internal.id,
+			title: page.label || page.path,
+			hasMarkdown: servesMarkdown(layout)
+		}));
+	}));
+	return [...destinations, ...discovered.flat()];
+}
+/** Whether a layout's pages serve a Markdown Representation. */
+function servesMarkdown(layout) {
+	return layout._internal.toMarkdown !== void 0;
+}
+/** A derived layout's Route Discovery failed, so the Live pages can't all be listed. */
+var RouteDiscoveryError = class extends Error {
+	constructor(cause) {
+		super(cause instanceof Error ? cause.message : String(cause), { cause });
+	}
+};
+
+//#endregion
+export { RouteDiscoveryError, listLivePages };