@markless/router 0.4.0 → 0.5.0

package/dist/vite/runtime/create-server-entry.js

@@ -1,25 +1,125 @@
-import { t as __marklessDebugBootstrapSource } from "../../debug-channel-CSzo-Zj8.js";
-import { i as normalizeRouteFileId, n as matchRouteManifest, t as buildRouteManifestFromFileIds } from "../../route-manifest-DPgGIyrS.js";
-import { renderToString } from "@markless/web/render-to-string";
-import { renderToStream } from "@markless/web/render-to-stream";
+import { i as SCROLL_ATTRIBUTE, n as PREFETCH_ATTRIBUTE, r as REPLACE_ATTRIBUTE, t as LINK_ATTRIBUTE } from "../../link-attributes-nY1Qkmx2.js";
+import { i as ROUTE_SCRIPT_TYPE, n as requestLocals, r as HTML_ATTRIBUTES_SLOT } from "../../request-locals-BFPF6Vdm.js";
+import { a as normalizeRouteFileId, r as matchRouteManifest, t as buildRouteManifestFromFileIds } from "../../route-manifest-Bw_nFohL.js";
+import { a as startFragmentNavigation, i as FRAGMENT_REQUEST_HEADER, n as FRAGMENT_PREFETCH_TTL_MS, o as appendModulePreloads, r as FRAGMENT_REGION_END, s as listenForLinkIntent, t as FRAGMENT_APPEND_END } from "../../fragment-navigation-CIiNnFFc.js";
+import { n as __marklessDebugBootstrapSource } from "../../debug-channel-Di6SppZv.js";
+import { CONTAINER_RETIRE_PROPERTY, renderToString } from "@markless/web/render-to-string";
+import { STREAMED_ARM_SELECTOR, STREAM_ARM_EXECUTOR_GLOBAL, renderToStream } from "@markless/web/render-to-stream";
 import { normalizeMarklessDevError, renderMarklessDevErrorDocument } from "@markless/bundler/dev-error";
+//#region src/vite/runtime/link-bridge-module.ts
+/** Marks the page's link bridge script: inline in dev, a module stub importing the shared bridge in a build. */
+const LINK_BRIDGE_SCRIPT_ATTRIBUTE = "data-markless-router-link-resumer";
+function linkBridgeModulePath(base, hash) {
+	return `${base.replace(/\/?$/, "/")}_markless/links.${hash}.js`;
+}
+//#endregion
+//#region src/vite/runtime/page-http.ts
+const RESPONSE_COMMITTED_CODE = "MARKLESS_ROUTER_RESPONSE_COMMITTED";
+function createPageHttp(request, url) {
+	let committed;
+	let status;
+	let statusText;
+	const refuse = (write) => {
+		throw new Error(`${RESPONSE_COMMITTED_CODE}: ${write} ran after the page's response started streaming to the browser, so its status and headers were already sent. Set http.response before the first byte goes out: in the page body, before any await that outlives the first flush.`);
+	};
+	const headers = new PageHeaders((write, unchanged) => {
+		if (committed && !unchanged(committed.headers)) refuse(write);
+	});
+	const response = {
+		headers,
+		get status() {
+			return status;
+		},
+		set status(value) {
+			if (committed && value !== committed.status) refuse(`http.response.status = ${value}`);
+			status = value;
+		},
+		get statusText() {
+			return statusText;
+		},
+		set statusText(value) {
+			if (committed && value !== committed.statusText) refuse(`http.response.statusText = ${JSON.stringify(value)}`);
+			statusText = value;
+		}
+	};
+	return {
+		context: {
+			locals: requestLocals(request) ?? {},
+			request,
+			response,
+			url
+		},
+		commit(fallbackStatus, routerHeaders) {
+			const sent = new Headers(routerHeaders);
+			for (const [name, value] of headers) if (name !== "set-cookie") sent.set(name, value);
+			for (const cookie of headers.getSetCookie()) sent.append("set-cookie", cookie);
+			committed = {
+				status: status ?? fallbackStatus,
+				statusText,
+				headers: sent
+			};
+			return {
+				status: committed.status,
+				...statusText === void 0 ? {} : { statusText },
+				headers: sent
+			};
+		}
+	};
+}
+var PageHeaders = class extends Headers {
+	#guard;
+	constructor(guard) {
+		super();
+		this.#guard = guard;
+	}
+	set(name, value) {
+		this.#guard(`http.response.headers.set(${JSON.stringify(name)})`, (sent) => name.toLowerCase() === "set-cookie" ? sent.getSetCookie().includes(value) : sent.get(name) === value);
+		super.set(name, value);
+	}
+	append(name, value) {
+		this.#guard(`http.response.headers.append(${JSON.stringify(name)})`, (sent) => name.toLowerCase() === "set-cookie" ? sent.getSetCookie().includes(value) : (sent.get(name)?.split(", ") ?? []).includes(value));
+		if (!headerValues(this, name).includes(value)) super.append(name, value);
+	}
+	delete(name) {
+		this.#guard(`http.response.headers.delete(${JSON.stringify(name)})`, (sent) => !sent.has(name));
+		super.delete(name);
+	}
+};
+function headerValues(headers, name) {
+	return name.toLowerCase() === "set-cookie" ? headers.getSetCookie() : headers.get(name)?.split(", ") ?? [];
+}
+//#endregion
 //#region src/vite/runtime/create-server-entry.ts
 const DOCUMENT_CHILDREN_PLACEHOLDER = "__markless_router_document_children__";
 function createServerEntry(options) {
 	const manifest = buildRouteManifestFromFileIds(options.routeFileIds);
 	assertCurrentRouteAssets(options);
+	const fragmentBridge = options.fragmentEntryPath !== void 0 && options.navigation !== "render" ? {
+		entry: options.fragmentEntryPath,
+		source: options.fragmentNavigationSource ?? startFragmentNavigation.toString(),
+		prefetch: options.prefetch !== false,
+		pages: manifest.routes.map((route) => route.pathname.replace(/:[^/]+/g, ":"))
+	} : void 0;
+	const fragmentNavigation = fragmentBridge !== void 0;
+	const linkBridges = !options.dev && options.navigationEntryPath ? linkBridgeModules(options.base ?? "/", options.navigationEntryPath, fragmentNavigation || options.prefetch !== false, options.documentNavigation === "document", fragmentBridge) : void 0;
 	async function fetch(request) {
 		const url = new URL(request.url);
+		const linkBridge = linkBridges?.find((module) => module.path === url.pathname);
+		if (linkBridge) return new Response(linkBridge.source, { headers: {
+			"content-type": "text/javascript;charset=utf-8",
+			"cache-control": "public, max-age=31536000, s-maxage=31536000, immutable"
+		} });
+		const fragment = fragmentNavigation && request.headers.get("x-markless-fragment") === "1";
 		if (isNitroApiPathname(url.pathname)) return new Response("Not found", { status: 404 });
 		const match = matchRouteManifest(url.pathname, manifest);
-		if (!match) return renderStatusPage(url, manifest.statusPages.notFound, 404, "Not found");
+		if (!match) return renderStatusPage(url, manifest.statusPages.notFound, 404, "Not found", fragment, request);
 		try {
-			return await renderPage(url, match.route.file, match.params, 200);
+			return await renderPage(url, match.route.file, match.params, 200, fragment, request);
 		} catch (error) {
 			console.error("[markless-router] page render failed:", error);
 			if (options.dev) return renderDevelopmentError(url, error);
 			try {
-				return await renderStatusPage(url, manifest.statusPages.error, 500, "Internal Server Error");
+				return await renderStatusPage(url, manifest.statusPages.error, 500, "Internal Server Error", fragment, request);
 			} catch (errorPageError) {
 				console.error("[markless-router] error page render failed:", errorPageError);
 				return new Response("Internal Server Error", {
@@ -50,15 +150,18 @@ function createServerEntry(options) {
 			});
 		}
 	}
-	async function renderStatusPage(url, file, status, fallbackText) {
+	async function renderStatusPage(url, file, status, fallbackText, fragment, request) {
 		if (!file) return new Response(fallbackText, { status });
-		return renderPage(url, file, {}, status);
+		return renderPage(url, file, {}, status, fragment, request);
 	}
-	async function renderPage(url, file, params, status) {
+	async function renderPage(url, file, params, status, fragment, request) {
 		const loadPageModule = options.pageModuleLoaders[file];
 		if (!loadPageModule) return new Response(`Page module not found: ${file}`, { status: 500 });
+		const cookie = request.headers.get("cookie");
 		const pageModule = await loadPageModule();
+		const http = createPageHttp(request, url);
 		const pageProps = {
+			http: http.context,
 			params,
 			url: {
 				href: url.href,
@@ -69,45 +172,60 @@ function createServerEntry(options) {
 		};
 		const documentModule = options.documentModuleLoader ? await options.documentModuleLoader() : void 0;
 		const headers = { "content-type": "text/html;charset=utf-8" };
+		if (fragmentNavigation) headers.vary = FRAGMENT_REQUEST_HEADER;
 		const baseArtifact = pageModule.default;
 		const renderSsr = baseArtifact?.renderSsr ?? pageModule.marklessRenderSsr;
 		if (!renderSsr) {
 			const shell = await renderDocumentShell(documentModule, pageProps, "");
 			const message = `Page module must export an Markless compiled artifact: ${escapeHtml(file)}`;
-			return new Response(fillDocumentChildren(shell, message), {
-				status,
-				headers
-			});
+			return new Response(fillDocumentChildren(shell, message), http.commit(status, headers));
 		}
-		const pageArtifact = routedPageArtifact(renderSsr, baseArtifact, pageProps, file, options.navigationEntryPath, options.routeStylesheets?.[file]);
-		const routedArtifact = options.prerenderWakeEntryPath ? {
+		const documentLoads = options.documentNavigation === "document";
+		const linkIntent = fragmentNavigation || options.prefetch !== false;
+		const destinationPreloads = documentLoads || fragmentNavigation ? options.routeSsrModulePreloads : options.routeModulePreloads;
+		const pageArtifact = routedPageArtifact(renderSsr, baseArtifact, pageProps, file, options.navigationEntryPath, pageStylesheets(options, file), documentModule?.default?.headInjections ?? [], linkIntent ? (html) => linkIntentPreloads(html, pageProps.url.href, manifest, destinationPreloads, fragmentNavigation) : void 0, documentLoads, fragmentBridge, linkBridges);
+		let rendersStorage = false;
+		const routedArtifact = {
 			...pageArtifact,
-			prerenderWakeModuleUrl: options.prerenderWakeEntryPath
-		} : pageArtifact;
+			...options.prerenderWakeEntryPath ? { prerenderWakeModuleUrl: options.prerenderWakeEntryPath } : {},
+			async renderSsr(renderProps, renderContext) {
+				const output = await pageArtifact.renderSsr(renderProps, renderContext);
+				if (documentStorageRecords(output.state).length > 0) rendersStorage = true;
+				return output;
+			}
+		};
+		const privateToVisitor = () => {
+			if (!rendersStorage) return;
+			headers["cache-control"] = "private";
+			headers.vary = headers.vary ? `${headers.vary}, cookie` : "cookie";
+		};
 		const renderOptions = {
+			cookie,
 			props: pageProps,
 			resumeModuleUrl: options.resumeEntryPath ?? baseArtifact?.resumeModuleUrl,
-			modulePreloads: (html) => modulePreloadsForPage(file, html, pageProps.url.href, manifest, options.routeModulePreloads, options.routeSsrModulePreloads)
+			modulePreloads: (html) => landingModulePreloads(options.routeSsrModulePreloads?.[file], linkBridges?.[html.includes("href=\"#/") ? 1 : 0].path)
 		};
 		if (options.render === "blocking") {
 			const pageHtml = splitLeadingHeadHtml(await renderToString(routedArtifact, renderOptions));
-			const shell = await renderDocumentShell(documentModule, pageProps, pageHtml.headHtml);
-			return new Response(fillDocumentChildren(shell, pageHtml.bodyHtml), {
-				status,
-				headers
-			});
+			privateToVisitor();
+			const shell = await renderDocumentShell(documentModule, pageProps, pageHtml.headHtml, options.importMap);
+			const html = fragment ? fragmentDocument(shell, pageHtml.bodyHtml, documentLoads) + FRAGMENT_REGION_END : fillDocumentChildren(shell, pageHtml.bodyHtml);
+			return new Response(html, http.commit(status, headers));
 		}
 		const stream = await renderToStream(routedArtifact, renderOptions);
+		privateToVisitor();
 		const pageHtml = splitLeadingHeadHtml(stream.shell);
-		const shell = await renderDocumentShell(documentModule, pageProps, pageHtml.headHtml);
-		if (stream.pendingArmCount === 0) return new Response(fillDocumentChildren(shell, pageHtml.bodyHtml), {
-			status,
-			headers
-		});
+		const shell = await renderDocumentShell(documentModule, pageProps, pageHtml.headHtml, options.importMap);
+		if (stream.pendingArmCount === 0) {
+			const html = fragment ? fragmentDocument(shell, pageHtml.bodyHtml, documentLoads) + FRAGMENT_REGION_END : fillDocumentChildren(shell, pageHtml.bodyHtml);
+			return new Response(html, http.commit(status, headers));
+		}
 		const placeholderAt = shell.indexOf(DOCUMENT_CHILDREN_PLACEHOLDER);
-		const prefix = placeholderAt === -1 ? shell : shell.slice(0, placeholderAt) + pageHtml.bodyHtml;
-		const suffix = placeholderAt === -1 ? "" : shell.slice(placeholderAt + 37);
+		const prefix = fragment ? fragmentDocument(shell, pageHtml.bodyHtml, documentLoads) + FRAGMENT_REGION_END : placeholderAt === -1 ? shell : shell.slice(0, placeholderAt) + pageHtml.bodyHtml;
+		const suffix = fragment || placeholderAt === -1 ? "" : shell.slice(placeholderAt + 37);
+		const appendEnd = fragment ? FRAGMENT_APPEND_END : "";
 		const encoder = new TextEncoder();
+		const sent = http.commit(status, headers);
 		let cancelled = false;
 		let completed = false;
 		const body = new ReadableStream({
@@ -116,7 +234,7 @@ function createServerEntry(options) {
 				try {
 					for await (const chunk of stream.appends()) {
 						if (cancelled) return;
-						controller.enqueue(encoder.encode(chunk));
+						controller.enqueue(encoder.encode(chunk + appendEnd));
 					}
 				} catch (error) {
 					if (cancelled) return;
@@ -126,7 +244,7 @@ function createServerEntry(options) {
 					return;
 				}
 				if (cancelled) return;
-				controller.enqueue(encoder.encode(suffix));
+				if (suffix) controller.enqueue(encoder.encode(suffix));
 				controller.close();
 				completed = true;
 			},
@@ -136,10 +254,7 @@ function createServerEntry(options) {
 				stream.cancel(reason);
 			}
 		});
-		return new Response(body, {
-			status,
-			headers
-		});
+		return new Response(body, sent);
 	}
 	return { fetch };
 }
@@ -161,15 +276,35 @@ function assertCurrentRouteAssets(options) {
 		if (JSON.stringify(actual) !== JSON.stringify(expected)) throw new Error(`Markless Router ${label} client-asset routes are stale; expected ${JSON.stringify(expected)}, received ${JSON.stringify(actual)}. Rebuild the client environment before the server environment.`);
 	}
 }
-function routedPageArtifact(renderSsr, baseArtifact, pageProps, file, navigationEntryPath, stylesheetHrefs) {
-	const headInjections = [...baseArtifact?.headInjections ?? [], ...(stylesheetHrefs ?? []).map((href) => ({
-		tag: "link",
-		location: "head",
-		attributes: {
-			rel: "stylesheet",
-			href
-		}
-	}))];
+function dedupeHeadLinks(injections) {
+	const seen = /* @__PURE__ */ new Set();
+	return injections.filter((injection) => {
+		const href = injection.tag === "link" ? injection.attributes?.href : void 0;
+		if (typeof href !== "string") return true;
+		if (seen.has(href)) return false;
+		seen.add(href);
+		return true;
+	});
+}
+function pageStylesheets(options, file) {
+	const documentHrefs = options.documentStylesheets ?? [];
+	const routeHrefs = options.routeStylesheets?.[file];
+	if (documentHrefs.length === 0) return routeHrefs;
+	return [.../* @__PURE__ */ new Set([...documentHrefs, ...routeHrefs ?? []])];
+}
+function routedPageArtifact(renderSsr, baseArtifact, pageProps, file, navigationEntryPath, stylesheetHrefs, documentHeadInjections = [], intentPreloads, documentLoads = false, fragment, linkBridgeModules) {
+	const headInjections = dedupeHeadLinks([
+		...documentHeadInjections,
+		...baseArtifact?.headInjections ?? [],
+		...(stylesheetHrefs ?? []).map((href) => ({
+			tag: "link",
+			location: "head",
+			attributes: {
+				rel: "stylesheet",
+				href
+			}
+		}))
+	]);
 	return {
 		resumeModuleUrl: baseArtifact?.resumeModuleUrl,
 		inlineResumerSources: baseArtifact?.inlineResumerSources,
@@ -179,7 +314,7 @@ function routedPageArtifact(renderSsr, baseArtifact, pageProps, file, navigation
 			const output = await renderSsr(renderProps ?? pageProps, renderContext);
 			if (!output) return { html: "" };
 			const routeScript = output.state || output.view ? renderRouteScript(file) : "";
-			const linkBridge = navigationEntryPath ? renderLinkBridgeScript(navigationEntryPath) : "";
+			const linkBridge = navigationEntryPath ? renderLinkBridgeScript(navigationEntryPath, intentPreloads?.(output.html), documentLoads, fragment, output.html.includes("href=\"#/"), linkBridgeModules) : "";
 			const stateWithProps = withPagePropsCell(output.state, pageProps);
 			return routeScript || linkBridge || stateWithProps !== output.state ? {
 				...output,
@@ -191,6 +326,7 @@ function routedPageArtifact(renderSsr, baseArtifact, pageProps, file, navigation
 }
 function withPagePropsCell(state, props) {
 	if (!state || typeof state !== "object") return state;
+	const { http: _serverOnly, ...browserProps } = props;
 	const cells = state.cells;
 	if (!Array.isArray(cells) || cells.some((cell) => cell?.graphNodeId === "prop:props")) return state;
 	return {
@@ -199,25 +335,50 @@ function withPagePropsCell(state, props) {
 			graphNodeId: "prop:props",
 			name: "props",
 			valueKind: "object",
-			directValue: props
+			directValue: browserProps
 		}]
 	};
 }
-function modulePreloadsForPage(file, html, baseHref, manifest, routeModulePreloads, routeSsrModulePreloads) {
+function landingModulePreloads(routePreloads, linkBridgePath) {
 	const preloads = [];
-	const seen = /* @__PURE__ */ new Set();
-	addModulePreloads(preloads, seen, routeSsrModulePreloads?.[file]);
-	if (!routeModulePreloads || !html.includes("data-markless-router-link")) return preloads.length > 0 ? preloads : void 0;
-	for (const href of routerLinkHrefs(html)) {
-		const url = parseSameOriginUrl(href, baseHref);
-		const match = url && matchRouteManifest(url.pathname, manifest);
-		addModulePreloads(preloads, seen, match && routeModulePreloads[match.route.file]);
-	}
+	addModulePreloads(preloads, /* @__PURE__ */ new Set(), routePreloads);
+	if (linkBridgePath) preloads.push(linkBridgePath);
 	return preloads.length > 0 ? preloads : void 0;
 }
 function routerLinkHrefs(html) {
 	return [...html.matchAll(/<a\b(?=[^>]*\bdata-markless-router-link(?:[\s=>]|$))(?=[^>]*\bhref="([^"]*)")[^>]*>/g)].map((match) => unescapeHtmlAttribute(match[1] ?? ""));
 }
+function anchorHrefs(html) {
+	return [...html.matchAll(/<a\b(?=[^>]*\bhref="([^"]*)")[^>]*>/g)].map((match) => unescapeHtmlAttribute(match[1] ?? ""));
+}
+function linkIntentPreloads(html, baseHref, manifest, routes, plainAnchors = false) {
+	const destinations = Object.create(null);
+	for (const href of plainAnchors ? anchorHrefs(html) : routerLinkHrefs(html)) {
+		const url = parseSameOriginUrl(href, baseHref);
+		const match = url && matchRouteManifest(url.pathname, manifest);
+		const preloads = match && routes?.[match.route.file];
+		if (url && preloads?.length) destinations[url.pathname] = preloads;
+	}
+	return destinations;
+}
+function indexedPreloads(intentPreloads) {
+	const preloads = [];
+	const indexes = /* @__PURE__ */ new Map();
+	const destinations = Object.create(null);
+	for (const [pathname, list] of Object.entries(intentPreloads)) destinations[pathname] = list.map((preload) => {
+		const key = JSON.stringify(preload);
+		let index = indexes.get(key);
+		if (index === void 0) {
+			index = preloads.push(preload) - 1;
+			indexes.set(key, index);
+		}
+		return index;
+	});
+	return {
+		preloads,
+		destinations
+	};
+}
 function parseSameOriginUrl(href, base) {
 	try {
 		const current = new URL(base);
@@ -249,16 +410,17 @@ function splitLeadingHeadHtml(html) {
 		headHtml: html.slice(0, containerStart)
 	};
 }
-async function renderDocumentShell(documentModule, pageProps, headHtml) {
-	const attributes = htmlAttributes(documentModule, pageProps);
+async function renderDocumentShell(documentModule, pageProps, headHtml, importMap = "") {
+	const written = {};
 	const documentHtml = await renderDocumentModule(documentModule, {
 		...pageProps,
 		children: DOCUMENT_CHILDREN_PLACEHOLDER
-	});
+	}, written);
+	const attributes = htmlAttributes(documentModule, pageProps, written);
 	if (documentHtml !== void 0) return [
 		"<!doctype html>",
 		`<html${renderAttributes(attributes)}>`,
-		insertHeadHtml(documentHtml, headHtml),
+		insertImportMap(insertHeadHtml(documentHtml, headHtml), importMap),
 		"</html>"
 	].join("");
 	return [
@@ -266,6 +428,7 @@ async function renderDocumentShell(documentModule, pageProps, headHtml) {
 		`<html${renderAttributes(attributes)}>`,
 		"<head>",
 		"<meta charset=\"utf-8\">",
+		importMap,
 		"<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">",
 		headHtml,
 		"</head>",
@@ -280,8 +443,14 @@ function fillDocumentChildren(documentShell, children) {
 	if (at === -1) return documentShell;
 	return documentShell.slice(0, at) + children + documentShell.slice(at + 37);
 }
-async function renderDocumentModule(documentModule, props) {
-	const output = await documentModule?.default?.renderSsr?.(props);
+function fragmentDocument(shell, bodyHtml, documentLoads) {
+	const bodyAt = documentLoads ? -1 : shell.search(/<body[\s>]/i);
+	const bodyOpenEnd = bodyAt === -1 ? -1 : shell.indexOf(">", bodyAt);
+	if (bodyOpenEnd === -1) return fillDocumentChildren(shell, bodyHtml);
+	return `${shell.slice(0, bodyOpenEnd + 1)}${bodyHtml}</body></html>`;
+}
+async function renderDocumentModule(documentModule, props, htmlAttributes) {
+	const output = await documentModule?.default?.renderSsr?.(props, { [HTML_ATTRIBUTES_SLOT]: htmlAttributes });
 	assertDocumentStorageFree(output);
 	return output?.html;
 }
@@ -303,31 +472,28 @@ function insertHeadHtml(documentHtml, headHtml) {
 	return `${documentHtml.slice(0, headEnd)}${headHtml}${documentHtml.slice(headEnd)}`;
 }
 function renderRouteScript(file) {
-	return `<script type="@markless/core/route">${escapeScriptJson({ file })}<\/script>`;
+	return `<script type="${ROUTE_SCRIPT_TYPE}">${escapeScriptJson({ file })}<\/script>`;
 }
-function renderLinkBridgeScript(resumeEntryPath) {
-	const debugBootstrap = typeof __MARKLESS_DEBUG_ENABLED__ !== "undefined" && __MARKLESS_DEBUG_ENABLED__ ? `<script data-markless-router-debug-bootstrap>${escapeInlineScript(`(() => {
-	const d = document;
-	const s = d.currentScript;
-	const r = s && s.closest('[data-async-container]');
-	if (!r) return;
-	try { globalThis[Symbol.for('markless.debug.channel.v1.bootstrap')] = ${__marklessDebugBootstrapSource()}(r, 'ssr-inline', false); } catch {}
-})();`)}<\/script>` : "";
-	const debugRegistration = typeof __MARKLESS_DEBUG_ENABLED__ !== "undefined" && __MARKLESS_DEBUG_ENABLED__ ? `
-	try {
-		const key = Symbol.for('markless.debug.channel.v1.bootstrap');
-		const md = globalThis[key];
-		if (md) { md.router('ssr-link-bridge'); md.activate(); }
-	} catch {}` : "";
-	return `${debugBootstrap}<script data-markless-router-link-resumer>${escapeInlineScript(`(() => {
-	const d = document;
-	const s = d.currentScript;
-	const r = s && s.closest('[data-async-container]');
-	if (!r || r.__marklessRouterLinkResumerStarted) return;
-	r.__marklessRouterLinkResumerStarted = true;
-	const linkAttr = 'data-markless-router-link';
-	const replaceAttr = 'data-markless-router-replace';
-	const scrollAttr = 'data-markless-router-scroll';
+function linkBridgeBody(resumeEntryPath, linkIntent, documentLoads, fragment, page) {
+	const inline = !("module" in page);
+	const fragmentNavigation = fragment !== void 0;
+	const fragmentSource = fragment ? `
+(${fragment.source})(d,()=>(${escapeScriptJson(fragmentConfig(fragment, documentLoads))}),${inline ? escapeScriptJson(page.intentPreloads ?? {}) : "r"},(href)=>import(href));` : "";
+	const indexed = !fragmentNavigation && linkIntent ? inline ? page.intentPreloads && indexedPreloads(page.intentPreloads) : {
+		preloads: "preloads",
+		destinations: "destinations"
+	} : void 0;
+	const intentSource = indexed ? `
+	const preloads = ${inline ? escapeScriptJson(indexed.preloads) : "p"};
+	const destinations = ${inline ? escapeScriptJson(indexed.destinations) : "q"};
+	const destination = (url) => destinations[url.pathname]?.map((index) => preloads[index]);
+	const append = (${appendModulePreloads.toString()});
+	(${listenForLinkIntent.toString()})(d, linkAttr, (url) => {
+		append(d, destination(url));
+	}, prefetchAttr);` : "";
+	const hashClickSource = fragment && !page.hashLinks ? "" : `
+	if (d.__marklessRouterHashClickStarted) return;
+	d.__marklessRouterHashClickStarted = true;
 	const anchorFrom = (event) => {
 		const target = event.composedPath && event.composedPath()[0] || event.target;
 		return target && target.closest ? target.closest('a[href]') : target && target.parentElement && target.parentElement.closest ? target.parentElement.closest('a[href]') : null;
@@ -340,10 +506,7 @@ function renderLinkBridgeScript(resumeEntryPath) {
 			return null;
 		}
 	};
-	if (location.hash && location.hash.startsWith('#/')) {
-		import(${JSON.stringify(resumeEntryPath)}).catch(() => {});
-	}
-	r.addEventListener('click', async (event) => {
+	d.addEventListener('click', async (event) => {
 		if (event.defaultPrevented || event.button !== 0 || event.metaKey || event.altKey || event.ctrlKey || event.shiftKey) return;
 		const anchor = anchorFrom(event);
 		if (!anchor || !anchor.hasAttribute(linkAttr) || anchor.hasAttribute('download')) return;
@@ -351,7 +514,7 @@ function renderLinkBridgeScript(resumeEntryPath) {
 		if (target && target !== '_self') return;
 		if (anchor.relList && anchor.relList.contains('external')) return;
 		const url = sameOrigin(anchor.href);
-		if (!url) return;
+		if (!url${documentLoads || fragmentNavigation ? " || !url.hash.startsWith('#/')" : ""}) return;
 		event.preventDefault();
 		try {
 			const mod = await import(${JSON.stringify(resumeEntryPath)});
@@ -369,11 +532,95 @@ function renderLinkBridgeScript(resumeEntryPath) {
 			setTimeout(() => { throw error; });
 			location.assign(url.href);
 		}
-	}, true);${debugRegistration}
+	}, true);`;
+	const debugRegistration = typeof __MARKLESS_DEBUG_ENABLED__ !== "undefined" && __MARKLESS_DEBUG_ENABLED__ ? `
+	try {
+		const key = Symbol.for('markless.debug.channel.v1.bootstrap');
+		const md = globalThis[key];
+		if (md) { md.router('ssr-link-bridge'); md.activate(); }
+	} catch {}` : "";
+	return `${fragmentSource}${fragment && !hashClickSource ? "" : `
+if(d.__marklessRouterLinkResumerStarted${fragment ? "&&d.__marklessRouterHashClickStarted" : ""})return;d.__marklessRouterLinkResumerStarted=true;`}${intentSource || hashClickSource ? `
+	const linkAttr = ${JSON.stringify(LINK_ATTRIBUTE)};` : ""}${intentSource ? `
+	const prefetchAttr = ${JSON.stringify(PREFETCH_ATTRIBUTE)};` : ""}${hashClickSource ? `
+	const replaceAttr = ${JSON.stringify(REPLACE_ATTRIBUTE)};
+	const scrollAttr = ${JSON.stringify(SCROLL_ATTRIBUTE)};` : ""}${intentSource}
+if(location.hash&&location.hash.startsWith('#/'))import(${JSON.stringify(resumeEntryPath)}).catch(()=>{});${hashClickSource}${debugRegistration}`;
+}
+function linkBridgeModules(base, resumeEntryPath, linkIntent, documentLoads, fragment) {
+	const variant = (hashLinks) => {
+		const source = `export default(r,p,q)=>{const d=document;${linkBridgeBody(resumeEntryPath, linkIntent, documentLoads, fragment, {
+			module: true,
+			hashLinks
+		})}\n};`;
+		return {
+			path: linkBridgeModulePath(base, contentHash(source)),
+			source
+		};
+	};
+	const withoutHashLinks = variant(false);
+	return [withoutHashLinks, fragment ? variant(true) : withoutHashLinks];
+}
+function contentHash(text) {
+	let hash = 2166136261;
+	for (let at = 0; at < text.length; at++) hash = Math.imul(hash ^ text.charCodeAt(at), 16777619);
+	return (hash >>> 0).toString(36);
+}
+function renderLinkBridgeScript(resumeEntryPath, intentPreloads, documentLoads = false, fragment, hashLinks = false, modules) {
+	const debugBootstrap = typeof __MARKLESS_DEBUG_ENABLED__ !== "undefined" && __MARKLESS_DEBUG_ENABLED__ ? `<script data-markless-router-debug-bootstrap>${escapeInlineScript(`(() => {
+	const d = document;
+	const s = d.currentScript;
+	const r = s && s.closest('[data-async-container]');
+	if (!r) return;
+	try { globalThis[Symbol.for('markless.debug.channel.v1.bootstrap')] = ${__marklessDebugBootstrapSource()}(r, 'ssr-inline', false); } catch {}
+})();`)}<\/script>` : "";
+	const module = modules?.[hashLinks ? 1 : 0];
+	if (module) {
+		const indexed = !fragment && intentPreloads ? indexedPreloads(intentPreloads) : void 0;
+		const args = fragment ? [escapeScriptJson(intentPreloads ?? {})] : indexed ? [
+			"0",
+			escapeScriptJson(indexed.preloads),
+			escapeScriptJson(indexed.destinations)
+		] : [];
+		return `${debugBootstrap}<script type="module" ${LINK_BRIDGE_SCRIPT_ATTRIBUTE}>${escapeInlineScript(`import b from${JSON.stringify(module.path)};b(${args.join(",")})`)}<\/script>`;
+	}
+	const body = linkBridgeBody(resumeEntryPath, intentPreloads !== void 0, documentLoads, fragment, {
+		intentPreloads,
+		hashLinks
+	});
+	return `${debugBootstrap}<script ${LINK_BRIDGE_SCRIPT_ATTRIBUTE}>${escapeInlineScript(`(()=>{const d=document,s=d.currentScript,r=s&&s.closest('[data-async-container]');if(!r)return;${body}
 })();`)}<\/script>`;
 }
-function htmlAttributes(documentModule, pageProps) {
-	const attributes = documentModule?.__marklessRouterHtmlAttributes?.(pageProps) ?? { lang: "en" };
+function fragmentConfig(fragment, documentLoads) {
+	return {
+		entry: fragment.entry,
+		linkAttribute: LINK_ATTRIBUTE,
+		prefetchAttribute: PREFETCH_ATTRIBUTE,
+		replaceAttribute: REPLACE_ATTRIBUTE,
+		scrollAttribute: SCROLL_ATTRIBUTE,
+		routeScriptType: ROUTE_SCRIPT_TYPE,
+		retireProperty: CONTAINER_RETIRE_PROPERTY,
+		streamExecutorGlobal: STREAM_ARM_EXECUTOR_GLOBAL,
+		streamedArmSelector: STREAMED_ARM_SELECTOR,
+		requestHeader: FRAGMENT_REQUEST_HEADER,
+		regionEndMarker: FRAGMENT_REGION_END,
+		appendMarker: FRAGMENT_APPEND_END,
+		documentLoads,
+		hoverDwellMs: 20,
+		prefetchTtlMs: FRAGMENT_PREFETCH_TTL_MS,
+		prefetchConnections: 2,
+		endpointPrefixes: [API_PATHNAME_PREFIX],
+		idleFragments: 2,
+		idleWithoutConnectionInfo: true,
+		prefetch: fragment.prefetch,
+		pages: fragment.pages
+	};
+}
+function htmlAttributes(documentModule, pageProps, written) {
+	const attributes = documentModule?.__marklessRouterHtmlAttributes?.(pageProps) ?? {
+		lang: "en",
+		...written
+	};
 	const normalized = {};
 	for (const [name, value] of Object.entries(attributes)) {
 		if (value === false || value === null || value === void 0) continue;
@@ -393,8 +640,19 @@ function escapeScriptJson(value) {
 function escapeInlineScript(value) {
 	return value.replace(/<\/script/gi, "<\\/script");
 }
+const API_PATHNAME_PREFIX = "/api";
 function isNitroApiPathname(pathname) {
-	return pathname === "/api" || pathname.startsWith("/api/");
+	return pathname === API_PATHNAME_PREFIX || pathname.startsWith(`${API_PATHNAME_PREFIX}/`);
+}
+function insertImportMap(html, importMap) {
+	if (!importMap) return html;
+	const head = /<head(?:\s[^>]*)?>/i.exec(html);
+	if (!head) return `${importMap}${html}`;
+	const afterHead = head.index + head[0].length;
+	const headEnd = html.indexOf("</head>", afterHead);
+	const charset = /<meta\s[^>]*charset[^>]*>(?:<\/meta>)?/i.exec(html.slice(afterHead));
+	const at = charset && (headEnd === -1 || afterHead + charset.index < headEnd) ? afterHead + charset.index + charset[0].length : afterHead;
+	return `${html.slice(0, at)}${importMap}${html.slice(at)}`;
 }
 //#endregion
 export { createServerEntry };