@timber-js/app 0.2.0-alpha.16 → 0.2.0-alpha.161

package/dist/server/internal.js

@@ -0,0 +1,3652 @@
+import { a as classifyMetadataRoute, i as METADATA_ROUTE_CONVENTIONS, o as getMetadataRouteAutoLink, r as canonicalize, s as getMetadataRouteServePath } from "../_chunks/canonicalize-P41GR6tY.js";
+import { n as classifyUrlSegment } from "../_chunks/segment-classify-CDDRVKs7.js";
+import { A as runWithRequestContext, D as getSearchParams, G as getTraceId, H as generateTraceId, I as getSetCookieHeaders, J as setSpanAttribute, K as replaceTraceId, L as getWaitUntil, M as setMutableCookieContext, N as setSegmentParams, O as getSegmentParams, P as getCookie, Q as requestContextAls, R as isDebug, T as getHeader, U as getOtelTraceId, X as earlyHintsSenderAls, Y as withSpan, _ as RedirectSignal, a as logProxyError, c as logRequestReceived, d as logSwrRefetchFailed, et as timingAls, f as logWaitUntilRejected, g as DenySignal, h as swallow, i as logMiddlewareShortCircuit, j as setMatchedSegmentPath, k as markResponseFlushed, l as logRouteError, m as setLogger, n as logCacheMiss, o as logRenderError, p as logWaitUntilUnsupported, q as runWithTraceId, r as logMiddlewareError, s as logRequestCompleted, t as getLogger, u as logSlowRequest, v as RenderError, w as applyRequestHeaderOverlay } from "../_chunks/logger-B_O6-mdJ.js";
+import { i as coerce, t as executeAction } from "../_chunks/actions-cjklt63G.js";
+import { a as getManifestEntry, b as wasInvalidatedSince, c as lookupPrebuiltPayload, d as checkVersionSkew, i as storeOverlayEntry, l as setPrebuiltPayloadSource, n as lookupOverlay, o as hasPrebuiltPayloadSource, r as overlayKey, s as isParamIndependent, u as applyReloadHeaders, v as currentInvalidationEpoch, x as createSingleflight, y as lastInvalidationEpochFor } from "../_chunks/cache-api-CzYUlgXA.js";
+import "../client/error-boundary.js";
+import { n as toBracketKey } from "../_chunks/resolve-schema-3iUvBV5T.js";
+import "../_chunks/segment-context-ZDnXDkbz.js";
+import { readFile } from "node:fs/promises";
+import { createHash } from "node:crypto";
+import React, { createElement, useContext } from "react";
+//#region src/server/server-timing.ts
+/**
+* Server-Timing header — dev-mode timing breakdowns for Chrome DevTools.
+*
+* Collects timing entries per request using ALS. Each pipeline phase
+* (proxy, middleware, render, SSR, access, fetch) records an entry.
+* Before response flush, entries are formatted into a Server-Timing header.
+*
+* Only active in dev mode — zero overhead in production.
+*
+* See: https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Server-Timing
+* Task: LOCAL-290
+*/
+/**
+* Run a callback with a per-request timing collector.
+* Must be called at the top of the request pipeline (wraps the full request).
+*/
+function runWithTimingCollector(fn) {
+	return timingAls.run({ entries: [] }, fn);
+}
+/**
+* Run a function and automatically record its duration as a timing entry.
+* Returns the function's result. No-ops the recording if outside a collector.
+*/
+async function withTiming(name, desc, fn) {
+	const store = timingAls.getStore();
+	if (!store) return fn();
+	const start = performance.now();
+	try {
+		return await fn();
+	} finally {
+		const dur = Math.round(performance.now() - start);
+		store.entries.push({
+			name,
+			dur,
+			desc
+		});
+	}
+}
+/**
+* Get the Server-Timing header value for the current request.
+* Returns null if no entries exist or outside a collector.
+*
+* Format: `name;dur=123;desc="description", name2;dur=456`
+* See RFC 6797 / Server-Timing spec for format details.
+*/
+function getServerTimingHeader() {
+	const store = timingAls.getStore();
+	if (!store || store.entries.length === 0) return null;
+	const nameCounts = /* @__PURE__ */ new Map();
+	const parts = store.entries.map((entry) => {
+		const count = nameCounts.get(entry.name) ?? 0;
+		nameCounts.set(entry.name, count + 1);
+		const uniqueName = count > 0 ? `${entry.name}-${count}` : entry.name;
+		return {
+			...entry,
+			name: uniqueName
+		};
+	}).map((entry) => {
+		let part = `${entry.name};dur=${entry.dur}`;
+		if (entry.desc) {
+			const safeDesc = entry.desc.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
+			part += `;desc="${safeDesc}"`;
+		}
+		return part;
+	});
+	const MAX_HEADER_SIZE = 4096;
+	let result = "";
+	for (let i = 0; i < parts.length; i++) {
+		const candidate = result ? `${result}, ${parts[i]}` : parts[i];
+		if (candidate.length > MAX_HEADER_SIZE) break;
+		result = candidate;
+	}
+	return result || null;
+}
+//#endregion
+//#region src/server/stream-utils.ts
+/**
+* Wrap a response body with stream-lifecycle timing instrumentation.
+*
+* Logs firstChunk, lastChunk, close, maxGap (largest inter-chunk gap),
+* chunk count, and byte count on stream termination (clean close OR
+* cancellation/disconnect). Gated behind `serverTiming: 'detailed'`.
+*
+* Uses a manual reader pump to guarantee logging on all termination
+* paths — TransformStream.flush() is not called on cancellation.
+*/
+function wrapResponseWithStreamTiming(body, startTime) {
+	let firstChunkMs = 0;
+	let lastChunkMs = 0;
+	let maxGapMs = 0;
+	let prevChunkTime = 0;
+	let chunks = 0;
+	let bytes = 0;
+	let cancelled = false;
+	function emitLog() {
+		const closeMs = Math.round(performance.now() - startTime);
+		console.debug(`[timber] stream-lifecycle: firstChunk=${firstChunkMs}ms lastChunk=${lastChunkMs}ms close=${closeMs}ms maxGap=${maxGapMs}ms chunks=${chunks} bytes=${bytes}` + (cancelled ? " cancelled=true" : ""));
+	}
+	const reader = body.getReader();
+	return new ReadableStream({
+		async pull(controller) {
+			try {
+				const { done, value } = await reader.read();
+				if (done) {
+					emitLog();
+					controller.close();
+					return;
+				}
+				const now = performance.now();
+				const relativeMs = Math.round(now - startTime);
+				if (chunks === 0) firstChunkMs = relativeMs;
+				else {
+					const gap = Math.round(now - prevChunkTime);
+					if (gap > maxGapMs) maxGapMs = gap;
+				}
+				prevChunkTime = now;
+				lastChunkMs = relativeMs;
+				chunks++;
+				bytes += value.byteLength;
+				controller.enqueue(value);
+			} catch (err) {
+				emitLog();
+				controller.error(err);
+			}
+		},
+		cancel(reason) {
+			cancelled = true;
+			emitLog();
+			reader.cancel(reason).catch(() => {});
+		}
+	});
+}
+//#endregion
+//#region src/server/instrumentation.ts
+/**
+* Instrumentation — loads and runs the user's instrumentation.ts file.
+*
+* instrumentation.ts is a file convention at the project root that exports:
+* - register() — called once at server startup, before the first request
+* - onRequestError() — called for every unhandled server error
+* - logger — any object with info/warn/error/debug methods
+*
+* See design/17-logging.md §"instrumentation.ts — The Entry Point"
+*/
+var _initialized = false;
+var _onRequestError = null;
+/**
+* Load and initialize the user's instrumentation.ts module.
+*
+* - Awaits register() before returning (server blocks on this).
+* - Picks up the logger export and wires it into the framework logger.
+* - Stores onRequestError for later invocation.
+*
+* @param loader - Function that dynamically imports the user's instrumentation module.
+*                 Returns null if no instrumentation.ts exists.
+*/
+async function loadInstrumentation(loader) {
+	if (_initialized) return;
+	_initialized = true;
+	let mod;
+	try {
+		mod = await loader();
+	} catch (error) {
+		console.error("[timber] Failed to load instrumentation.ts:", error);
+		return;
+	}
+	if (!mod) return;
+	if (mod.logger && typeof mod.logger.info === "function") setLogger(mod.logger);
+	if (typeof mod.onRequestError === "function") _onRequestError = mod.onRequestError;
+	if (typeof mod.register === "function") try {
+		await mod.register();
+	} catch (error) {
+		console.error("[timber] instrumentation.ts register() threw:", error);
+		throw error;
+	}
+}
+/**
+* Call the user's onRequestError hook. Catches and logs any errors thrown
+* by the hook itself — it must not affect the response.
+*/
+async function callOnRequestError(error, request, context) {
+	if (!_onRequestError) return;
+	try {
+		await _onRequestError(error, request, context);
+	} catch (hookError) {
+		console.error("[timber] onRequestError hook threw:", hookError);
+	}
+}
+/**
+* Check if onRequestError is registered.
+*/
+function hasOnRequestError() {
+	return _onRequestError !== null;
+}
+//#endregion
+//#region src/server/pipeline-helpers.ts
+/**
+* Only __proto__ needs stripping — it has a language-level setter that
+* changes the prototype chain of spread copies. constructor and prototype
+* are harmless own properties on null-prototype objects.
+*/
+var DANGEROUS_KEYS = /* @__PURE__ */ new Set(["__proto__"]);
+/**
+* Deep-walk a value returned by a segment param codec, producing a
+* sanitized copy where every plain object is null-prototype and
+* dangerous keys (__proto__, constructor, prototype) are stripped at
+* every depth.
+*
+* Non-plain objects (Date, Map, class instances, etc.) are returned
+* as-is — they cannot be poisoned by `{...x}` spread and may carry
+* author-intended prototype methods.
+*
+* Arrays are walked element-wise.
+*
+* Performance: URL params are bounded by URL length (~8 KB). Realistic
+* trees are <1 KB. The recursive walk is sub-microsecond.
+*
+* See TIM-655, TIM-855, TIM-873, design/13-security.md
+*/
+function sanitizeParamValue(value) {
+	if (value === null || typeof value !== "object") return value;
+	if (Array.isArray(value)) return value.map(sanitizeParamValue);
+	const proto = Object.getPrototypeOf(value);
+	if (proto !== Object.prototype && proto !== null) return value;
+	const out = Object.create(null);
+	for (const key of Object.keys(value)) if (!DANGEROUS_KEYS.has(key)) out[key] = sanitizeParamValue(value[key]);
+	return out;
+}
+/**
+* Build a proxy resolver closure from the declared source. Called exactly
+* once at `createPipeline` setup time, so the hot path sees only the branch
+* that corresponds to this pipeline's configured variant.
+*
+* Returns `null` when the app has no proxy.ts — the hot path short-circuits
+* around `runProxyPhase` entirely in that case.
+*
+* Accepts the sugar form (a bare `ProxyExport` — function or function array)
+* and normalises it to the static variant. Functions and arrays are
+* structurally distinct from the tagged `{ kind: 'lazy', loader }` object,
+* so discrimination is unambiguous.
+*/
+function makeProxyResolver(proxy) {
+	if (proxy === void 0) return null;
+	if (typeof proxy === "function" || Array.isArray(proxy)) {
+		const exp = proxy;
+		return () => exp;
+	}
+	if (proxy.kind === "static") {
+		const exp = proxy.export;
+		return () => exp;
+	}
+	const loader = proxy.loader;
+	return async () => (await loader()).default;
+}
+/**
+* Apply all Set-Cookie headers from the cookie jar to a Headers object.
+* Each cookie gets its own Set-Cookie header per RFC 6265 §4.1.
+*/
+function applyCookieJar(headers) {
+	for (const value of getSetCookieHeaders()) headers.append("Set-Cookie", value);
+}
+/**
+* Merge framework-managed response headers onto a terminal response without
+* overwriting headers the terminal response already set itself.
+*/
+function mergeMissingHeaders(target, source) {
+	const existingKeys = new Set([...target.keys()].map((key) => key.toLowerCase()));
+	for (const [key, value] of source.entries()) if (!existingKeys.has(key.toLowerCase())) target.append(key, value);
+}
+/**
+* Clone a Response into a fresh one whose header bag is guaranteed mutable.
+*
+* `Response.redirect()` and some platform-level passthrough responses (notably
+* on Cloudflare Workers) return objects with frozen header bags. Calling
+* `.set()` or `.append()` on them throws `TypeError: immutable`, which the
+* pipeline can hit when it appends Set-Cookie or Server-Timing entries.
+*
+* The pipeline calls this at the producer sites where user-controlled
+* responses enter the framework — `outcomeToResponse` for all phase outcomes,
+* and `handleRequest` for metadata-route and auto-sitemap user handlers — so
+* downstream code can write headers without runtime feature-detection.
+*
+* The clone is unconditional. This is a deliberate trade: we avoid a
+* try/catch + thrown `TypeError` on every request (the previous probe-based
+* approach paid that cost on the hot path) and accept one cheap Response
+* rewrap at the framework boundary instead.
+*/
+function cloneWithMutableHeaders(response) {
+	return new Response(response.body, {
+		status: response.status,
+		statusText: response.statusText,
+		headers: new Headers(response.headers)
+	});
+}
+/**
+* Build a redirect Response from a RedirectSignal.
+*
+* For RSC payload requests (client navigation), returns 204 + X-Timber-Redirect
+* so the client router can perform a soft SPA redirect. A raw 302 would be
+* turned into an opaque redirect by fetch({redirect:'manual'}), crashing
+* createFromFetch. See design/19-client-navigation.md.
+*/
+function buildRedirectResponse(signal, req, headers) {
+	if ((req.headers.get("Accept") ?? "").includes("text/x-component")) {
+		headers.set("X-Timber-Redirect", signal.location);
+		return new Response(null, {
+			status: 204,
+			headers
+		});
+	}
+	headers.set("Location", signal.location);
+	return new Response(null, {
+		status: signal.status,
+		headers
+	});
+}
+/**
+* Fire the user's onRequestError hook with request context.
+* Extracts request info from the Request object and calls the instrumentation hook.
+*/
+async function fireOnRequestError(error, req, phase) {
+	const url = new URL(req.url);
+	const headersObj = {};
+	req.headers.forEach((v, k) => {
+		headersObj[k] = v;
+	});
+	await callOnRequestError(error, {
+		method: req.method,
+		path: url.pathname,
+		headers: headersObj
+	}, {
+		phase,
+		routePath: url.pathname,
+		routeType: "page",
+		traceId: getTraceId()
+	});
+}
+//#endregion
+//#region src/server/proxy.ts
+/**
+* Run the proxy pipeline.
+*
+* @param proxyExport - The default export from proxy.ts (function or array)
+* @param req - The incoming request
+* @param next - The continuation that proceeds to route matching and rendering
+* @returns The final response
+*/
+async function runProxy(proxyExport, req, next) {
+	const fns = Array.isArray(proxyExport) ? proxyExport : [proxyExport];
+	let i = fns.length;
+	let composed = next;
+	while (i--) {
+		const fn = fns[i];
+		const downstream = composed;
+		composed = () => Promise.resolve(fn(req, downstream));
+	}
+	return composed();
+}
+//#endregion
+//#region src/server/middleware-runner.ts
+/**
+* Run a route's middleware function.
+*
+* @param middlewareFn - The default export from the route's middleware.ts
+* @param ctx - The middleware context (req, params, headers, requestHeaders, searchParams)
+* @returns A Response if middleware short-circuited, or undefined to continue
+*/
+async function runMiddleware(middlewareFn, ctx) {
+	const result = await middlewareFn(ctx);
+	if (result instanceof Response) return result;
+}
+/**
+* Run all middleware functions in the segment chain, root to leaf.
+*
+* Execution is top-down: root middleware runs first, leaf middleware runs last.
+* All middleware share the same MiddlewareContext — a parent that sets
+* ctx.requestHeaders makes it visible to child middleware and downstream components.
+*
+* Short-circuits on the first middleware that returns a Response.
+* Remaining middleware in the chain do not execute.
+*
+* @param chain - Middleware functions ordered root-to-leaf
+* @param ctx - Shared middleware context
+* @returns A Response if any middleware short-circuited, or undefined to continue
+*/
+async function runMiddlewareChain(chain, ctx) {
+	for (const fn of chain) {
+		const result = await fn(ctx);
+		if (result instanceof Response) return result;
+	}
+}
+/**
+* Per-request marker for synthetic re-render requests that should NOT
+* re-execute `middleware.ts`. The action-dispatch wrapper runs middleware
+* once on the inbound action POST; when validation fails on the no-JS
+* path, it builds a synthetic GET that flows through the normal pipeline
+* to render the page with `getFormFlash()` data. Without this marker, the
+* pipeline would run middleware a second time on that synthetic GET.
+*
+* The set is keyed by the synthetic Request object itself, so the entry
+* lives exactly as long as the request and is garbage-collected with it.
+* Cannot be set or detected by user code — there is no header, no URL
+* parameter, nothing on the wire that an attacker could spoof.
+*
+* See TIM-871.
+*
+* @internal — framework use only.
+*/
+var middlewareBypassRequests = /* @__PURE__ */ new WeakSet();
+/**
+* Check whether a request was marked to bypass middleware.
+*
+* Called by `handleRequest` in pipeline-phases.ts before invoking the
+* middleware phase. Returns false for any request not explicitly marked.
+*
+* @internal
+*/
+function shouldBypassMiddleware(req) {
+	return middlewareBypassRequests.has(req);
+}
+//#endregion
+//#region src/server/metadata-social.ts
+/**
+* Render Open Graph metadata into head element descriptors.
+*
+* Handles og:title, og:description, og:image (with dimensions/alt),
+* og:video, og:audio, og:article:author, and other OG properties.
+*/
+function renderOpenGraph(og, elements) {
+	const simpleProps = [
+		["og:title", og.title],
+		["og:description", og.description],
+		["og:url", og.url],
+		["og:site_name", og.siteName],
+		["og:locale", og.locale],
+		["og:type", og.type],
+		["og:article:published_time", og.publishedTime],
+		["og:article:modified_time", og.modifiedTime]
+	];
+	for (const [property, content] of simpleProps) if (content) elements.push({
+		tag: "meta",
+		attrs: {
+			property,
+			content
+		}
+	});
+	if (og.images) if (typeof og.images === "string") elements.push({
+		tag: "meta",
+		attrs: {
+			property: "og:image",
+			content: og.images
+		}
+	});
+	else {
+		const imgList = Array.isArray(og.images) ? og.images : [og.images];
+		for (const img of imgList) {
+			elements.push({
+				tag: "meta",
+				attrs: {
+					property: "og:image",
+					content: img.url
+				}
+			});
+			if (img.width) elements.push({
+				tag: "meta",
+				attrs: {
+					property: "og:image:width",
+					content: String(img.width)
+				}
+			});
+			if (img.height) elements.push({
+				tag: "meta",
+				attrs: {
+					property: "og:image:height",
+					content: String(img.height)
+				}
+			});
+			if (img.alt) elements.push({
+				tag: "meta",
+				attrs: {
+					property: "og:image:alt",
+					content: img.alt
+				}
+			});
+		}
+	}
+	if (og.videos) for (const video of og.videos) elements.push({
+		tag: "meta",
+		attrs: {
+			property: "og:video",
+			content: video.url
+		}
+	});
+	if (og.audio) for (const audio of og.audio) elements.push({
+		tag: "meta",
+		attrs: {
+			property: "og:audio",
+			content: audio.url
+		}
+	});
+	if (og.authors) for (const author of og.authors) elements.push({
+		tag: "meta",
+		attrs: {
+			property: "og:article:author",
+			content: author
+		}
+	});
+}
+/**
+* Render Twitter Card metadata into head element descriptors.
+*
+* Handles twitter:card, twitter:site, twitter:title, twitter:image,
+* twitter:player, and twitter:app (per-platform name/id/url).
+*/
+function renderTwitter(tw, elements) {
+	const simpleProps = [
+		["twitter:card", tw.card],
+		["twitter:site", tw.site],
+		["twitter:site:id", tw.siteId],
+		["twitter:title", tw.title],
+		["twitter:description", tw.description],
+		["twitter:creator", tw.creator],
+		["twitter:creator:id", tw.creatorId]
+	];
+	for (const [name, content] of simpleProps) if (content) elements.push({
+		tag: "meta",
+		attrs: {
+			name,
+			content
+		}
+	});
+	if (tw.images) if (typeof tw.images === "string") elements.push({
+		tag: "meta",
+		attrs: {
+			name: "twitter:image",
+			content: tw.images
+		}
+	});
+	else {
+		const imgList = Array.isArray(tw.images) ? tw.images : [tw.images];
+		for (const img of imgList) {
+			const url = typeof img === "string" ? img : img.url;
+			elements.push({
+				tag: "meta",
+				attrs: {
+					name: "twitter:image",
+					content: url
+				}
+			});
+		}
+	}
+	if (tw.players) for (const player of tw.players) {
+		elements.push({
+			tag: "meta",
+			attrs: {
+				name: "twitter:player",
+				content: player.playerUrl
+			}
+		});
+		if (player.width) elements.push({
+			tag: "meta",
+			attrs: {
+				name: "twitter:player:width",
+				content: String(player.width)
+			}
+		});
+		if (player.height) elements.push({
+			tag: "meta",
+			attrs: {
+				name: "twitter:player:height",
+				content: String(player.height)
+			}
+		});
+		if (player.streamUrl) elements.push({
+			tag: "meta",
+			attrs: {
+				name: "twitter:player:stream",
+				content: player.streamUrl
+			}
+		});
+	}
+	if (tw.app) {
+		const platforms = [
+			["iPhone", "iphone"],
+			["iPad", "ipad"],
+			["googlePlay", "googleplay"]
+		];
+		if (tw.app.name) {
+			for (const [key, tag] of platforms) if (tw.app.id?.[key]) elements.push({
+				tag: "meta",
+				attrs: {
+					name: `twitter:app:name:${tag}`,
+					content: tw.app.name
+				}
+			});
+		}
+		for (const [key, tag] of platforms) {
+			const id = tw.app.id?.[key];
+			if (id) elements.push({
+				tag: "meta",
+				attrs: {
+					name: `twitter:app:id:${tag}`,
+					content: id
+				}
+			});
+		}
+		for (const [key, tag] of platforms) {
+			const url = tw.app.url?.[key];
+			if (url) elements.push({
+				tag: "meta",
+				attrs: {
+					name: `twitter:app:url:${tag}`,
+					content: url
+				}
+			});
+		}
+	}
+}
+//#endregion
+//#region src/server/metadata-platform.ts
+/**
+* Render icon link elements (favicon, shortcut, apple-touch-icon, custom).
+*/
+function renderIcons(icons, elements) {
+	if (icons.icon) {
+		if (typeof icons.icon === "string") elements.push({
+			tag: "link",
+			attrs: {
+				rel: "icon",
+				href: icons.icon
+			}
+		});
+		else if (Array.isArray(icons.icon)) for (const icon of icons.icon) {
+			const attrs = {
+				rel: "icon",
+				href: icon.url
+			};
+			if (icon.sizes) attrs.sizes = icon.sizes;
+			if (icon.type) attrs.type = icon.type;
+			elements.push({
+				tag: "link",
+				attrs
+			});
+		}
+	}
+	if (icons.shortcut) {
+		const urls = Array.isArray(icons.shortcut) ? icons.shortcut : [icons.shortcut];
+		for (const url of urls) elements.push({
+			tag: "link",
+			attrs: {
+				rel: "shortcut icon",
+				href: url
+			}
+		});
+	}
+	if (icons.apple) {
+		if (typeof icons.apple === "string") elements.push({
+			tag: "link",
+			attrs: {
+				rel: "apple-touch-icon",
+				href: icons.apple
+			}
+		});
+		else if (Array.isArray(icons.apple)) for (const icon of icons.apple) {
+			const attrs = {
+				rel: "apple-touch-icon",
+				href: icon.url
+			};
+			if (icon.sizes) attrs.sizes = icon.sizes;
+			elements.push({
+				tag: "link",
+				attrs
+			});
+		}
+	}
+	if (icons.other) for (const icon of icons.other) {
+		const attrs = {
+			rel: icon.rel,
+			href: icon.url
+		};
+		if (icon.sizes) attrs.sizes = icon.sizes;
+		if (icon.type) attrs.type = icon.type;
+		elements.push({
+			tag: "link",
+			attrs
+		});
+	}
+}
+/**
+* Render alternate link elements (canonical, hreflang, media, types).
+*/
+function renderAlternates(alternates, elements) {
+	if (alternates.canonical) elements.push({
+		tag: "link",
+		attrs: {
+			rel: "canonical",
+			href: alternates.canonical
+		}
+	});
+	if (alternates.languages) for (const [lang, href] of Object.entries(alternates.languages)) elements.push({
+		tag: "link",
+		attrs: {
+			rel: "alternate",
+			hreflang: lang,
+			href
+		}
+	});
+	if (alternates.media) for (const [media, href] of Object.entries(alternates.media)) elements.push({
+		tag: "link",
+		attrs: {
+			rel: "alternate",
+			media,
+			href
+		}
+	});
+	if (alternates.types) for (const [type, href] of Object.entries(alternates.types)) elements.push({
+		tag: "link",
+		attrs: {
+			rel: "alternate",
+			type,
+			href
+		}
+	});
+}
+/**
+* Render site verification meta tags (Google, Yahoo, Yandex, custom).
+*/
+function renderVerification(verification, elements) {
+	const verificationProps = [
+		["google-site-verification", verification.google],
+		["y_key", verification.yahoo],
+		["yandex-verification", verification.yandex]
+	];
+	for (const [name, content] of verificationProps) if (content) elements.push({
+		tag: "meta",
+		attrs: {
+			name,
+			content
+		}
+	});
+	if (verification.other) for (const [name, value] of Object.entries(verification.other)) {
+		const content = Array.isArray(value) ? value.join(", ") : value;
+		elements.push({
+			tag: "meta",
+			attrs: {
+				name,
+				content
+			}
+		});
+	}
+}
+/**
+* Render Apple Web App meta tags and startup image links.
+*/
+function renderAppleWebApp(appleWebApp, elements) {
+	if (appleWebApp.capable) elements.push({
+		tag: "meta",
+		attrs: {
+			name: "apple-mobile-web-app-capable",
+			content: "yes"
+		}
+	});
+	if (appleWebApp.title) elements.push({
+		tag: "meta",
+		attrs: {
+			name: "apple-mobile-web-app-title",
+			content: appleWebApp.title
+		}
+	});
+	if (appleWebApp.statusBarStyle) elements.push({
+		tag: "meta",
+		attrs: {
+			name: "apple-mobile-web-app-status-bar-style",
+			content: appleWebApp.statusBarStyle
+		}
+	});
+	if (appleWebApp.startupImage) {
+		const images = Array.isArray(appleWebApp.startupImage) ? appleWebApp.startupImage : [{ url: appleWebApp.startupImage }];
+		for (const img of images) {
+			const attrs = {
+				rel: "apple-touch-startup-image",
+				href: typeof img === "string" ? img : img.url
+			};
+			if (typeof img === "object" && img.media) attrs.media = img.media;
+			elements.push({
+				tag: "link",
+				attrs
+			});
+		}
+	}
+}
+/**
+* Render App Links (al:*) meta tags for deep linking across platforms.
+*/
+function renderAppLinks(appLinks, elements) {
+	const platformEntries = [
+		["ios", appLinks.ios],
+		["android", appLinks.android],
+		["windows", appLinks.windows],
+		["windows_phone", appLinks.windowsPhone],
+		["windows_universal", appLinks.windowsUniversal]
+	];
+	for (const [platform, entries] of platformEntries) {
+		if (!entries) continue;
+		for (const entry of entries) for (const [key, value] of Object.entries(entry)) if (value !== void 0 && value !== null) elements.push({
+			tag: "meta",
+			attrs: {
+				property: `al:${platform}:${key}`,
+				content: String(value)
+			}
+		});
+	}
+	if (appLinks.web) {
+		if (appLinks.web.url) elements.push({
+			tag: "meta",
+			attrs: {
+				property: "al:web:url",
+				content: appLinks.web.url
+			}
+		});
+		if (appLinks.web.shouldFallback !== void 0) elements.push({
+			tag: "meta",
+			attrs: {
+				property: "al:web:should_fallback",
+				content: appLinks.web.shouldFallback ? "true" : "false"
+			}
+		});
+	}
+}
+/**
+* Render Apple iTunes smart banner meta tag.
+*/
+function renderItunes(itunes, elements) {
+	const parts = [`app-id=${itunes.appId}`];
+	if (itunes.affiliateData) parts.push(`affiliate-data=${itunes.affiliateData}`);
+	if (itunes.appArgument) parts.push(`app-argument=${itunes.appArgument}`);
+	elements.push({
+		tag: "meta",
+		attrs: {
+			name: "apple-itunes-app",
+			content: parts.join(", ")
+		}
+	});
+}
+//#endregion
+//#region src/server/metadata-render.ts
+/**
+* Convert resolved metadata into an array of head element descriptors.
+*
+* Each descriptor has a `tag` ('title', 'meta', 'link') and either
+* `content` (for <title>) or `attrs` (for <meta>/<link>).
+*
+* The framework's MetadataResolver component consumes these descriptors
+* and renders them into the <head>.
+*/
+function renderMetadataToElements(metadata) {
+	const elements = [];
+	if (typeof metadata.title === "string") elements.push({
+		tag: "title",
+		content: metadata.title
+	});
+	const simpleMetaProps = [
+		["description", metadata.description],
+		["generator", metadata.generator],
+		["application-name", metadata.applicationName],
+		["referrer", metadata.referrer],
+		["category", metadata.category],
+		["creator", metadata.creator],
+		["publisher", metadata.publisher]
+	];
+	for (const [name, content] of simpleMetaProps) if (content) elements.push({
+		tag: "meta",
+		attrs: {
+			name,
+			content
+		}
+	});
+	if (metadata.keywords) {
+		const content = Array.isArray(metadata.keywords) ? metadata.keywords.join(", ") : metadata.keywords;
+		elements.push({
+			tag: "meta",
+			attrs: {
+				name: "keywords",
+				content
+			}
+		});
+	}
+	if (metadata.robots) {
+		const content = typeof metadata.robots === "string" ? metadata.robots : renderRobotsObject(metadata.robots);
+		elements.push({
+			tag: "meta",
+			attrs: {
+				name: "robots",
+				content
+			}
+		});
+		if (typeof metadata.robots === "object" && metadata.robots.googleBot) {
+			const gbContent = typeof metadata.robots.googleBot === "string" ? metadata.robots.googleBot : renderRobotsObject(metadata.robots.googleBot);
+			elements.push({
+				tag: "meta",
+				attrs: {
+					name: "googlebot",
+					content: gbContent
+				}
+			});
+		}
+	}
+	if (metadata.openGraph) renderOpenGraph(metadata.openGraph, elements);
+	if (metadata.twitter) renderTwitter(metadata.twitter, elements);
+	if (metadata.icons) renderIcons(metadata.icons, elements);
+	if (metadata.manifest) elements.push({
+		tag: "link",
+		attrs: {
+			rel: "manifest",
+			href: metadata.manifest
+		}
+	});
+	if (metadata.alternates) renderAlternates(metadata.alternates, elements);
+	if (metadata.verification) renderVerification(metadata.verification, elements);
+	if (metadata.formatDetection) {
+		const parts = [];
+		if (metadata.formatDetection.telephone === false) parts.push("telephone=no");
+		if (metadata.formatDetection.email === false) parts.push("email=no");
+		if (metadata.formatDetection.address === false) parts.push("address=no");
+		if (parts.length > 0) elements.push({
+			tag: "meta",
+			attrs: {
+				name: "format-detection",
+				content: parts.join(", ")
+			}
+		});
+	}
+	if (metadata.authors) {
+		const authorList = Array.isArray(metadata.authors) ? metadata.authors : [metadata.authors];
+		for (const author of authorList) {
+			if (author.name) elements.push({
+				tag: "meta",
+				attrs: {
+					name: "author",
+					content: author.name
+				}
+			});
+			if (author.url) elements.push({
+				tag: "link",
+				attrs: {
+					rel: "author",
+					href: author.url
+				}
+			});
+		}
+	}
+	if (metadata.appleWebApp) renderAppleWebApp(metadata.appleWebApp, elements);
+	if (metadata.appLinks) renderAppLinks(metadata.appLinks, elements);
+	if (metadata.itunes) renderItunes(metadata.itunes, elements);
+	if (metadata.other) for (const [name, value] of Object.entries(metadata.other)) {
+		const content = Array.isArray(value) ? value.join(", ") : value;
+		elements.push({
+			tag: "meta",
+			attrs: {
+				name,
+				content
+			}
+		});
+	}
+	return elements;
+}
+function renderRobotsObject(robots) {
+	const parts = [];
+	if (robots.index === true) parts.push("index");
+	if (robots.index === false) parts.push("noindex");
+	if (robots.follow === true) parts.push("follow");
+	if (robots.follow === false) parts.push("nofollow");
+	return parts.join(", ");
+}
+//#endregion
+//#region src/server/metadata.ts
+/**
+* Resolve a title value with an optional template.
+*
+* - string → apply template if present
+* - { absolute: '...' } → use as-is, skip template
+* - { default: '...' } → use as fallback (no template applied)
+* - undefined → undefined
+*/
+function resolveTitle(title, template) {
+	if (title === void 0 || title === null) return;
+	if (typeof title === "string") return template ? template.replace("%s", title) : title;
+	if (title.absolute !== void 0) return title.absolute;
+	if (title.default !== void 0) return title.default;
+}
+/**
+* Resolve metadata from a segment chain.
+*
+* Processes entries from root layout to page (in segment order).
+* The merge algorithm:
+*   1. Shallow-merge all keys except title (later wins)
+*   2. Track the most recent title template
+*   3. Resolve the final title using the template
+*
+* In error state, the page entry is dropped and noindex is injected.
+*
+* See design/16-metadata.md §"Merge Algorithm"
+*/
+function resolveMetadata(entries, options = {}) {
+	const { errorState = false } = options;
+	const merged = {};
+	let titleTemplate;
+	let lastDefault;
+	let rawTitle;
+	for (const { metadata, isPage } of entries) {
+		if (errorState && isPage) continue;
+		if (metadata.title !== void 0 && typeof metadata.title === "object") {
+			if (metadata.title.template !== void 0) titleTemplate = metadata.title.template;
+			if (metadata.title.default !== void 0) lastDefault = metadata.title.default;
+		}
+		for (const key of Object.keys(metadata)) {
+			if (key === "title") continue;
+			merged[key] = metadata[key];
+		}
+		if (metadata.title !== void 0) rawTitle = metadata.title;
+	}
+	if (errorState) {
+		rawTitle = lastDefault !== void 0 ? { default: lastDefault } : rawTitle;
+		titleTemplate = void 0;
+	}
+	const resolvedTitle = resolveTitle(rawTitle, titleTemplate);
+	if (resolvedTitle !== void 0) merged.title = resolvedTitle;
+	if (errorState) merged.robots = "noindex";
+	return merged;
+}
+/**
+* Check if a string is an absolute URL.
+*/
+function isAbsoluteUrl(url) {
+	return url.startsWith("http://") || url.startsWith("https://") || url.startsWith("//");
+}
+/**
+* Resolve a relative URL against a base URL.
+*/
+function resolveUrl(url, base) {
+	if (isAbsoluteUrl(url)) return url;
+	return new URL(url, base).toString();
+}
+/**
+* Resolve relative URLs in metadata fields against metadataBase.
+*
+* Returns a new metadata object with URLs resolved. Absolute URLs are not modified.
+* If metadataBase is not set, returns the metadata unchanged.
+*/
+function resolveMetadataUrls(metadata) {
+	const base = metadata.metadataBase;
+	if (!base) return metadata;
+	const result = { ...metadata };
+	if (result.openGraph) {
+		result.openGraph = { ...result.openGraph };
+		if (typeof result.openGraph.images === "string") result.openGraph.images = resolveUrl(result.openGraph.images, base);
+		else if (Array.isArray(result.openGraph.images)) result.openGraph.images = result.openGraph.images.map((img) => ({
+			...img,
+			url: resolveUrl(img.url, base)
+		}));
+		else if (result.openGraph.images) result.openGraph.images = {
+			...result.openGraph.images,
+			url: resolveUrl(result.openGraph.images.url, base)
+		};
+		if (result.openGraph.url && !isAbsoluteUrl(result.openGraph.url)) result.openGraph.url = resolveUrl(result.openGraph.url, base);
+	}
+	if (result.twitter) {
+		result.twitter = { ...result.twitter };
+		if (typeof result.twitter.images === "string") result.twitter.images = resolveUrl(result.twitter.images, base);
+		else if (Array.isArray(result.twitter.images)) {
+			const resolved = result.twitter.images.map((img) => typeof img === "string" ? resolveUrl(img, base) : {
+				...img,
+				url: resolveUrl(img.url, base)
+			});
+			const allStrings = resolved.every((r) => typeof r === "string");
+			result.twitter.images = allStrings ? resolved : resolved;
+		} else if (result.twitter.images) result.twitter.images = {
+			...result.twitter.images,
+			url: resolveUrl(result.twitter.images.url, base)
+		};
+	}
+	if (result.alternates) {
+		result.alternates = { ...result.alternates };
+		if (result.alternates.canonical && !isAbsoluteUrl(result.alternates.canonical)) result.alternates.canonical = resolveUrl(result.alternates.canonical, base);
+		if (result.alternates.languages) {
+			const langs = {};
+			for (const [lang, url] of Object.entries(result.alternates.languages)) langs[lang] = isAbsoluteUrl(url) ? url : resolveUrl(url, base);
+			result.alternates.languages = langs;
+		}
+	}
+	if (result.icons) {
+		result.icons = { ...result.icons };
+		if (typeof result.icons.icon === "string") result.icons.icon = resolveUrl(result.icons.icon, base);
+		else if (Array.isArray(result.icons.icon)) result.icons.icon = result.icons.icon.map((i) => ({
+			...i,
+			url: resolveUrl(i.url, base)
+		}));
+		if (typeof result.icons.apple === "string") result.icons.apple = resolveUrl(result.icons.apple, base);
+		else if (Array.isArray(result.icons.apple)) result.icons.apple = result.icons.apple.map((i) => ({
+			...i,
+			url: resolveUrl(i.url, base)
+		}));
+	}
+	return result;
+}
+//#endregion
+//#region src/client/error-reconstituter.tsx
+/**
+* Reconstitutes a SerializableError into a real Error instance before
+* passing to the user's error component.
+*
+* TSX error pages are 'use client' components that receive { error: Error, digest, reset }.
+* Error objects are not RSC-serializable (React Flight throws "Only plain objects
+* can be passed to Client Components"). This wrapper receives the error as a plain
+* SerializableError object, reconstitutes a real Error instance, and passes it
+* to the user's error component — ensuring error instanceof Error works correctly.
+*
+* See design/spike-TIM-565-unify-error-pages.md §"Edge Case B"
+* See design/10-error-handling.md §"RSC → SSR for Error Pages via SerializableError"
+*/
+/**
+* Reconstitute a SerializableError into a real Error instance and render
+* the user's error component with the proper props.
+*/
+function ErrorReconstituter({ error: serialized, digest, reset, component, status, dangerouslyPassData }) {
+	return createElement(component, {
+		error: Object.assign(new Error(serialized.message), {
+			name: serialized.name,
+			...serialized.stack != null ? { stack: serialized.stack } : {}
+		}),
+		digest,
+		reset,
+		...status != null ? {
+			status,
+			dangerouslyPassData
+		} : {}
+	});
+}
+//#endregion
+//#region src/server/safe-load.ts
+/**
+* Custom error class for module load failures.
+*
+* Preserves the original error as `cause` while providing a
+* human-readable message with the file path.
+*/
+var ModuleLoadError = class extends Error {
+	/** The file path that failed to load. */
+	filePath;
+	constructor(filePath, cause) {
+		const originalMessage = cause instanceof Error ? cause.message : String(cause);
+		super(`[timber] Failed to load module ${filePath}\n  ${originalMessage}`, { cause });
+		this.name = "ModuleLoadError";
+		this.filePath = filePath;
+	}
+};
+/**
+* Load a route manifest module with enriched error context.
+*
+* On success: returns the module object (same as `loader.load()`).
+* On failure: throws `ModuleLoadError` with file path and original cause.
+*
+* For error rendering paths that need fallthrough instead of throwing,
+* callers should catch at the call site:
+*
+* ```ts
+* // Throwing (default) — route-element-builder, api-handler, etc.
+* const mod = await loadModule(segment.page);
+*
+* // Fallthrough — error-renderer, error-boundary-wrapper
+* const mod = await loadModule(segment.error).catch(() => null);
+* ```
+*/
+async function loadModule(loader) {
+	try {
+		return await loader.load();
+	} catch (error) {
+		throw new ModuleLoadError(loader.filePath, error);
+	}
+}
+/** Reverse index: status code → legacy file name. Built once at module load. */
+var STATUS_TO_LEGACY_FILE = Object.fromEntries(Object.entries({
+	"not-found": 404,
+	"forbidden": 403,
+	"unauthorized": 401
+}).map(([name, status]) => [status, name]));
+/**
+* Look up `{statusStr}` then `{categoryKey}` (e.g. "4xx" / "5xx") in a
+* status-file group on a single segment. Shared by all three fallback
+* chains — the only structural difference between component 4xx,
+* component 5xx, and JSON resolution is *which* group is searched and
+* how the per-segment loop is layered around it.
+*/
+function lookupInGroup(group, statusStr, categoryKey, segmentIndex, status) {
+	if (!group) return null;
+	const exact = group[statusStr];
+	if (exact) return {
+		file: exact,
+		status,
+		kind: "exact",
+		segmentIndex
+	};
+	const category = group[categoryKey];
+	if (category) return {
+		file: category,
+		status,
+		kind: "category",
+		segmentIndex
+	};
+	return null;
+}
+/**
+* Look up the legacy convention file (`not-found.tsx` / `forbidden.tsx` /
+* `unauthorized.tsx`) for `status` on a single segment. Returns null if
+* `status` has no legacy mapping or the file isn't present.
+*/
+function lookupLegacy(group, status, segmentIndex) {
+	if (!group) return null;
+	const name = STATUS_TO_LEGACY_FILE[status];
+	if (!name) return null;
+	const file = group[name];
+	return file ? {
+		file,
+		status,
+		kind: "legacy",
+		segmentIndex
+	} : null;
+}
+/**
+* Resolve the status-code file to render for a given HTTP status code.
+*
+* Walks the segment chain from leaf to root following the fallback chain
+* defined in design/10-error-handling.md. Returns null if no file is found
+* (caller should render the framework default).
+*
+* @param status - The HTTP status code (4xx or 5xx).
+* @param segments - The matched segment chain from root (index 0) to leaf (last).
+* @param format - The response format family ('component' or 'json'). Defaults to 'component'.
+*/
+function resolveStatusFile(status, segments, format = "component") {
+	if (status < 400 || status > 599) return null;
+	if (format === "json") return resolveJson(status, segments);
+	if (status <= 499) return resolve4xx(status, segments);
+	return resolve5xx(status, segments);
+}
+/**
+* 4xx component fallback chain — three separate full passes leaf→root.
+*
+* The passes must be separate (not interleaved per-segment) so that a
+* root-level `404.tsx` beats a leaf-level `error.tsx`. The 5xx chain
+* inverts this and is per-segment: a leaf's `error.tsx` beats a root's
+* `5xx.tsx`. This asymmetry is the only reason these two functions exist
+* separately.
+*
+*   Pass 1 — {status}.tsx → 4xx.tsx           (statusFiles)
+*   Pass 2 — not-found / forbidden / unauthorized (legacyStatusFiles)
+*   Pass 3 — error.tsx                         (error)
+*/
+function resolve4xx(status, segments) {
+	const statusStr = String(status);
+	for (let i = segments.length - 1; i >= 0; i--) {
+		const r = lookupInGroup(segments[i].statusFiles, statusStr, "4xx", i, status);
+		if (r) return r;
+	}
+	for (let i = segments.length - 1; i >= 0; i--) {
+		const r = lookupLegacy(segments[i].legacyStatusFiles, status, i);
+		if (r) return r;
+	}
+	for (let i = segments.length - 1; i >= 0; i--) {
+		const errorFile = segments[i].error;
+		if (errorFile) return {
+			file: errorFile,
+			status,
+			kind: "error",
+			segmentIndex: i
+		};
+	}
+	return null;
+}
+/**
+* 5xx component fallback chain — single pass, per-segment leaf→root.
+*
+* At each segment: {status}.tsx → 5xx.tsx → error.tsx. A leaf's
+* `error.tsx` therefore beats a root's `5xx.tsx`, which is the
+* intentional inverse of the 4xx chain.
+*/
+function resolve5xx(status, segments) {
+	const statusStr = String(status);
+	for (let i = segments.length - 1; i >= 0; i--) {
+		const segment = segments[i];
+		const r = lookupInGroup(segment.statusFiles, statusStr, "5xx", i, status);
+		if (r) return r;
+		if (segment.error) return {
+			file: segment.error,
+			status,
+			kind: "error",
+			segmentIndex: i
+		};
+	}
+	return null;
+}
+/**
+* JSON fallback chain (for both 4xx and 5xx) — single pass leaf→root.
+*
+* At each segment: {status}.json → {category}.json. No legacy compat,
+* no error.tsx — the JSON chain terminates at the category catch-all
+* and the caller falls back to a bare-JSON framework default.
+*/
+function resolveJson(status, segments) {
+	const statusStr = String(status);
+	const categoryKey = status >= 500 ? "5xx" : "4xx";
+	for (let i = segments.length - 1; i >= 0; i--) {
+		const r = lookupInGroup(segments[i].jsonStatusFiles, statusStr, categoryKey, i, status);
+		if (r) return r;
+	}
+	return null;
+}
+/**
+* Resolve the denial file for a parallel route slot.
+*
+* Slot denial is graceful degradation — no HTTP status on the wire.
+* Fallback chain: denied.tsx → default.tsx → null.
+*
+* @param slotNode - The segment node for the slot (segmentType === 'slot').
+*/
+function resolveSlotDenied(slotNode) {
+	const slotName = slotNode.segmentName.replace(/^@/, "");
+	if (slotNode.denied) return {
+		file: slotNode.denied,
+		slotName,
+		kind: "denied"
+	};
+	if (slotNode.default) return {
+		file: slotNode.default,
+		slotName,
+		kind: "default"
+	};
+	return null;
+}
+//#endregion
+//#region src/server/deny-boundary.ts
+/**
+* Deny boundary subsystem — the in-tree DenySignal flow.
+*
+* Three things live together here because they form a single flow:
+*
+* 1. **Chain construction** (`buildDenyPageChain`) — walks the matched
+*    segment chain at element-tree build time and produces a list of
+*    `DenyPageEntry` records ordered by specificity (specific status →
+*    category catch-all → `error.tsx`).
+*
+* 2. **Runtime matching** (`renderMatchingDenyPage`) — picks the first
+*    chain entry whose status filter matches the thrown DenySignal and
+*    returns a React element for the matching component. Used by
+*    `AccessGate` and `PageDenyBoundary` when they catch a deny.
+*
+* 3. **The page boundary itself** (`PageDenyBoundary`) — the async server
+*    component that wraps a server-component page, calls it, and catches
+*    `DenySignal` so the deny page renders in-tree (no throw reaches
+*    React Flight, single render pass).
+*
+* Plus the ALS helpers (`setDenyStatus` / `getDenyStatus`) the boundary
+* uses to thread the matched status code back to the pipeline so the
+* HTTP status reflects the deny.
+*
+* Folded into one module from the former `deny-page-resolver.ts` and
+* `page-deny-boundary.tsx` (TIM-853) — the names were misleading and the
+* three pieces only made sense together.
+*
+* See design/04-authorization.md, design/10-error-handling.md, TIM-666.
+*/
+/**
+* Find the first deny page in the chain that matches the given status code.
+* Returns a React element for the matching component, or null if no match.
+*/
+function renderMatchingDenyPage(chain, status, data) {
+	for (const entry of chain) {
+		if (entry.status === status) return renderDenyEntry(entry, status, data);
+		if (entry.status === 400 && status >= 400 && status <= 499) return renderDenyEntry(entry, status, data);
+		if (entry.status === 500 && status >= 500 && status <= 599) return renderDenyEntry(entry, status, data);
+		if (entry.status === null) return renderDenyEntry(entry, status, data);
+	}
+	return null;
+}
+/**
+* Build the element for a matched deny chain entry with the props contract
+* the file's convention documents:
+*
+* - Status-code and legacy files: { status, dangerouslyPassData }
+* - error.tsx (TSX): { error, digest, reset } via ErrorReconstituter, plus
+*   { status, dangerouslyPassData } for dual-shape implementations. Without
+*   the Error prop, any error.tsx written per the docs (reading
+*   error.message) crashes — turning a clean deny(404) into a 500. TIM-1081.
+* - error.mdx: plain { status } — server component, static content.
+*/
+function renderDenyEntry(entry, status, data) {
+	const h = createElement;
+	if (entry.kind !== "error") return h(entry.component, {
+		status,
+		dangerouslyPassData: data
+	});
+	if (entry.isMdx) return h(entry.component, { status });
+	return h(ErrorReconstituter, {
+		error: {
+			message: `Access denied with status ${status}`,
+			name: "DenySignal"
+		},
+		digest: null,
+		reset: void 0,
+		component: entry.component,
+		status,
+		dangerouslyPassData: data
+	});
+}
+/**
+* Set the deny status in the request context ALS.
+* Called from AccessGate / PageDenyBoundary when a DenySignal is caught.
+* The pipeline reads this after render to set the HTTP status code.
+*/
+function setDenyStatus(status) {
+	const store = requestContextAls.getStore();
+	if (store) store.denyStatus = status;
+}
+//#endregion
+//#region src/server/access-gate.tsx
+/**
+* AccessGate and SlotAccessGate — framework-injected async server components.
+*
+* AccessGate wraps each segment's layout in the element tree. It calls the
+* segment's access.ts before the layout renders. If access.ts calls deny()
+* or redirect(), the signal propagates as a render-phase throw — caught by
+* the flush controller to produce the correct HTTP status code.
+*
+* SlotAccessGate wraps parallel slot content. On denial, it renders the
+* graceful degradation chain: denied.tsx → default.tsx → null. Slot denial
+* does not affect the HTTP status code.
+*
+* See design/04-authorization.md and design/02-rendering-pipeline.md §"AccessGate"
+*/
+/**
+* Framework-injected access gate for segments.
+*
+* When a pre-computed `verdict` prop is provided (from the pre-render pass
+* in route-element-builder.ts), AccessGate replays it synchronously — no
+* async, no re-execution of access.ts, immune to Suspense timing. The OTEL
+* span was already emitted during the pre-render pass.
+*
+* When no verdict is provided (backward compat with tree-builder.ts),
+* AccessGate calls accessFn directly with OTEL instrumentation.
+*
+* access.ts is a pure gate — return values are discarded. The layout below
+* gets the same data by calling the same cached functions (React.cache dedup).
+*/
+function AccessGate(props) {
+	const { accessFn, segmentName, verdict, denyPages, children } = props;
+	if (verdict !== void 0) {
+		if (verdict === "pass") return children;
+		if (verdict instanceof DenySignal && denyPages) {
+			const denyElement = renderMatchingDenyPage(denyPages, verdict.status, verdict.data);
+			if (denyElement) {
+				setDenyStatus(verdict.status);
+				return denyElement;
+			}
+		}
+		throw verdict;
+	}
+	return accessGateFallback(accessFn, segmentName, denyPages, children);
+}
+/**
+* Async fallback for AccessGate when no pre-computed verdict is available.
+* Calls accessFn with OTEL instrumentation.
+*/
+async function accessGateFallback(accessFn, segmentName, denyPages, children) {
+	try {
+		await withSpan("timber.access", { "timber.segment": segmentName ?? "unknown" }, async () => {
+			try {
+				await accessFn();
+				await setSpanAttribute("timber.result", "pass");
+			} catch (error) {
+				if (error instanceof DenySignal) {
+					await setSpanAttribute("timber.result", "deny");
+					await setSpanAttribute("timber.deny_status", error.status);
+					if (error.sourceFile) await setSpanAttribute("timber.deny_file", error.sourceFile);
+				} else if (error instanceof RedirectSignal) await setSpanAttribute("timber.result", "redirect");
+				throw error;
+			}
+		});
+	} catch (error) {
+		if (error instanceof DenySignal && denyPages) {
+			const denyElement = renderMatchingDenyPage(denyPages, error.status, error.data);
+			if (denyElement) {
+				setDenyStatus(error.status);
+				return denyElement;
+			}
+		}
+		throw error;
+	}
+	return children;
+}
+/**
+* Framework-injected access gate for parallel slots.
+*
+* On denial, graceful degradation: denied.tsx → default.tsx → null.
+* The HTTP status code is unaffected — slot denial is a UI concern, not
+* a protocol concern. The parent layout and sibling slots still render.
+*
+* DeniedComponent is passed instead of a pre-built element so that
+* DenySignal.data can be forwarded as the dangerouslyPassData prop
+* and the slot name can be passed as the slot prop. See TIM-488.
+*
+* redirect() in slot access.ts is a dev-mode error — redirecting from a
+* slot doesn't make architectural sense.
+*/
+async function SlotAccessGate(props) {
+	const { accessFn, DeniedComponent, slotName, createElement, defaultFallback, children } = props;
+	try {
+		await accessFn();
+	} catch (error) {
+		if (error instanceof DenySignal) return buildDeniedFallback(DeniedComponent, slotName, error.data, createElement) ?? defaultFallback ?? null;
+		if (error instanceof RedirectSignal) {
+			if (isDebug()) console.error("[timber] redirect() is not allowed in slot access.ts. Slots use deny() for graceful degradation — denied.tsx → default.tsx → null. If you need to redirect, move the logic to the parent segment's access.ts.");
+			return buildDeniedFallback(DeniedComponent, slotName, void 0, createElement) ?? defaultFallback ?? null;
+		}
+		if (isDebug()) console.warn("[timber] Unhandled error in slot access.ts. Use deny() for access control, not unhandled throws.", error);
+		throw error;
+	}
+	return children;
+}
+/**
+* Build the denied fallback element dynamically with DenySignal data.
+* Returns null if no DeniedComponent is available.
+*/
+function buildDeniedFallback(DeniedComponent, slotName, data, createElement) {
+	if (!DeniedComponent) return null;
+	return createElement(DeniedComponent, {
+		slot: slotName,
+		dangerouslyPassData: data
+	});
+}
+//#endregion
+//#region src/server/param-coercion.ts
+/** Global schema codecs, set once at startup from virtual:timber-schema. */
+var _globalCodecs = null;
+/**
+* Run segment param coercion on the matched route's segments.
+*
+* When `globalCodecs` is provided (from app/schema.ts), uses the global
+* codec map keyed by bare param name. Otherwise falls back to loading
+* per-segment params.ts modules.
+*
+* Throws ParamCoercionError if any codec fails (→ 404).
+*
+* This runs BEFORE middleware, so ctx.segmentParams is already typed.
+* See design/07-routing.md §"Where Coercion Runs"
+* See design/41-global-params.md §"Pipeline Integration"
+*/
+async function coerceSegmentParams(match) {
+	const globalCodecs = _globalCodecs;
+	const mergeTarget = Object.create(null);
+	for (const key of Object.keys(match.segmentParams)) if (key !== "__proto__") mergeTarget[key] = match.segmentParams[key];
+	match.segmentParams = mergeTarget;
+	if (globalCodecs) {
+		for (const segment of match.segments) {
+			if (!segment.paramName) continue;
+			const bracketKey = toBracketKey(segment.segmentType, segment.paramName);
+			const codec = globalCodecs[bracketKey];
+			if (!codec) continue;
+			const key = segment.paramName;
+			try {
+				mergeTarget[key] = sanitizeParamValue(codec.parse(mergeTarget[key]));
+			} catch (err) {
+				const message = err instanceof Error ? err.message : String(err);
+				if (isDebug()) console.warn(`[timber] Global schema codec rejected value for param "${key}"\n  Error: ${message}\n  Raw value: ${JSON.stringify(mergeTarget[key])}\n  Hint: check the codec in app/schema.ts for key '${bracketKey}'.`);
+				throw new ParamCoercionError(message);
+			}
+		}
+		return;
+	}
+	for (const segment of match.segments) {
+		if (!segment.params) continue;
+		let mod;
+		try {
+			mod = await loadModule(segment.params);
+		} catch (err) {
+			const message = `Failed to load params module for segment "${segment.segmentName}": ${err instanceof Error ? err.message : String(err)}`;
+			if (isDebug()) console.warn(`[timber] Param coercion error: ${message}\n  Segment: ${segment.segmentName}\n  Params file: ${segment.params}`);
+			throw new ParamCoercionError(message);
+		}
+		const segmentParamsDef = mod.segmentParams;
+		if (!segmentParamsDef || typeof segmentParamsDef.parse !== "function") continue;
+		try {
+			const coerced = segmentParamsDef.parse(match.segmentParams);
+			for (const key of Object.keys(coerced)) if (key !== "__proto__") mergeTarget[key] = sanitizeParamValue(coerced[key]);
+		} catch (err) {
+			const message = err instanceof Error ? err.message : String(err);
+			if (isDebug()) {
+				const rawKeys = Object.keys(match.segmentParams).join(", ");
+				console.warn(`[timber] Param codec rejected values for segment "${segment.segmentName}"\n  Error: ${message}\n  Available raw params: { ${rawKeys} }\n  Params file: ${segment.params}\n  Hint: this usually means a codec threw for the raw URL value.\n  Check that the regex/schema accepts the actual path segment string.`);
+			}
+			throw new ParamCoercionError(message);
+		}
+	}
+}
+//#endregion
+//#region src/client/segment-update-context.ts
+/**
+* SegmentUpdateContext — React context for partial navigation updates.
+*
+* During partial navigation (server skips unchanged sync layouts), the
+* router builds a Map of segment path → ReactNode updates and passes it
+* as the context value. Mounted SegmentOutlet components read from this
+* context to decide whether to render the update or their cached content.
+*
+* SINGLETON GUARANTEE: Uses globalThis + Symbol.for — same pattern as
+* NavigationContext. The RSC client bundler can duplicate this module
+* across chunks (browser-entry graph + client-reference graph). With
+* ESM output, each chunk gets its own module scope — a bare createContext
+* at module level would create separate instances per chunk. globalThis
+* guarantees a single instance regardless of duplication.
+*
+* See design/19-client-navigation.md §"Singleton Guarantee via globalThis"
+*/
+var EMPTY_SEGMENT_UPDATES = /* @__PURE__ */ new Map();
+var CTX_KEY$1 = Symbol.for("__timber_segment_update_ctx");
+function getOrCreateContext$1() {
+	const existing = globalThis[CTX_KEY$1];
+	if (existing !== void 0) return existing;
+	if (typeof React.createContext === "function") {
+		const ctx = React.createContext(EMPTY_SEGMENT_UPDATES);
+		globalThis[CTX_KEY$1] = ctx;
+		return ctx;
+	}
+}
+getOrCreateContext$1();
+//#endregion
+//#region src/client/segment-outlet.tsx
+/**
+* SegmentOutlet — client component boundary at each layout segment.
+*
+* Each layout in the segment tree is wrapped with a SegmentOutlet that:
+* 1. Knows its segment path (prop from the server)
+* 2. Reads from SegmentUpdateContext for partial navigation updates
+* 3. Caches its rendered content in a ref across navigations
+*
+* On full navigation: receives new children via props, caches and renders them.
+* On partial navigation (this segment skipped): the context map has no entry
+* for this path, so the outlet returns cached content — preserving layout state.
+* On partial navigation (this segment updated): the context map has content
+* for this path, so the outlet renders the update.
+*
+* Uses React context instead of useSyncExternalStore to stay compatible
+* with concurrent rendering (transitions). All outlets re-render when the
+* context value changes, but each bails out quickly if its segment has
+* no update — same approach as Next.js LayoutRouter.
+*
+* Security: performance optimization only. The server always runs all
+* access.ts files regardless of segment skipping.
+* See design/13-security.md §"State tree manipulation".
+*/
+//#endregion
+//#region src/client/child-segment-context.ts
+/**
+* ChildSegmentContext — delivers child segment content to ChildSegmentOutlet.
+*
+* Each layout receives a stable <ChildSegmentOutlet /> client reference as
+* its `children` prop instead of varying server content. The actual child
+* content (page or inner layout) is provided via this context from a
+* ChildSegmentProvider placed ABOVE the layout in the element tree.
+*
+* This structural separation is what makes layout cache.component hits
+* possible: the cached layout payload contains a deterministic client
+* reference as children, not the varying inner content that changes per
+* route. Same pattern as Next.js LayoutRouter.
+*
+* SINGLETON GUARANTEE: Uses globalThis + Symbol.for — same pattern as
+* SegmentUpdateContext. The RSC client bundler can duplicate this module
+* across chunks; globalThis guarantees a single context instance.
+*
+* See design/45-cache-lifetimes.md §Layout Propagation.
+*/
+var CTX_KEY = Symbol.for("__timber_child_segment_ctx");
+function getOrCreateContext() {
+	const existing = globalThis[CTX_KEY];
+	if (existing !== void 0) return existing;
+	if (typeof React.createContext === "function") {
+		const ctx = React.createContext(null);
+		globalThis[CTX_KEY] = ctx;
+		return ctx;
+	}
+}
+var ChildSegmentContext = getOrCreateContext();
+//#endregion
+//#region src/client/child-segment-outlet.tsx
+/**
+* ChildSegmentOutlet — renders child segment content from context.
+*
+* Passed as `children` to every layout component, replacing the previous
+* pattern of passing rendered server content directly. The layout receives
+* a stable client reference (this component), and the actual child content
+* is delivered via ChildSegmentContext from a provider above the layout.
+*
+* This makes layout cache.component hits possible: the cached layout
+* payload contains this deterministic client reference, not varying
+* server content. On cache hit, the revived payload contains the layout
+* shell + this outlet; the provider above supplies the current request's
+* child content.
+*
+* See design/45-cache-lifetimes.md §Layout Propagation.
+*/
+function ChildSegmentOutlet() {
+	return useContext(ChildSegmentContext);
+}
+//#endregion
+//#region src/client/child-segment-provider.tsx
+/**
+* ChildSegmentProvider — wraps a layout to provide child segment content.
+*
+* Placed above the layout in the element tree so that ChildSegmentOutlet
+* (inside the layout's `children`) can read the actual child content.
+*
+* Tree structure:
+*   ChildSegmentProvider(childContent=innerElement)
+*     └── Layout(children=<ChildSegmentOutlet />)
+*          └── ChildSegmentOutlet → reads context → innerElement
+*
+* See design/45-cache-lifetimes.md §Layout Propagation.
+*/
+//#endregion
+//#region src/server/route-element-builder.ts
+/**
+* Thrown when a defineSegmentParams codec's parse() fails.
+* The pipeline catches this and responds with 404.
+*/
+var ParamCoercionError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "ParamCoercionError";
+	}
+};
+//#endregion
+//#region src/server/pipeline-metadata.ts
+/**
+* Metadata route helpers for the request pipeline.
+*
+* Handles serving static metadata files and serializing sitemap responses.
+* Extracted from pipeline.ts to keep files under 500 lines.
+*
+* See design/16-metadata.md §"Metadata Routes"
+*/
+/**
+* Content types that are text-based and should include charset=utf-8.
+* Binary formats (images) should not include charset.
+*/
+var TEXT_CONTENT_TYPES = /* @__PURE__ */ new Set([
+	"application/xml",
+	"text/plain",
+	"application/json",
+	"application/manifest+json",
+	"image/svg+xml"
+]);
+/**
+* Serve a static metadata file by reading it from disk.
+*
+* Static metadata route files (.xml, .txt, .json, .png, .ico, .svg, etc.)
+* are served as-is with the appropriate Content-Type header.
+* Text files include charset=utf-8; binary files do not.
+*
+* See design/16-metadata.md §"Metadata Routes"
+*/
+async function serveStaticMetadataFile(metaMatch) {
+	const { contentType, file } = metaMatch;
+	const isText = TEXT_CONTENT_TYPES.has(contentType);
+	const body = await readFile(file.filePath);
+	const headers = {
+		"Content-Type": isText ? `${contentType}; charset=utf-8` : contentType,
+		"Content-Length": String(body.byteLength),
+		"Cache-Control": "public, max-age=14400, must-revalidate"
+	};
+	return new Response(body, {
+		status: 200,
+		headers
+	});
+}
+/**
+* Serialize a sitemap array to XML.
+* Follows the sitemap.org protocol: https://www.sitemaps.org/protocol.html
+*/
+function serializeSitemap(entries) {
+	return `<?xml version="1.0" encoding="UTF-8"?>\n<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">\n${entries.map((e) => {
+		let xml = `  <url>\n    <loc>${escapeXml(e.url)}</loc>`;
+		if (e.lastModified) {
+			const date = e.lastModified instanceof Date ? e.lastModified.toISOString() : e.lastModified;
+			xml += `\n    <lastmod>${escapeXml(date)}</lastmod>`;
+		}
+		if (e.changeFrequency) xml += `\n    <changefreq>${escapeXml(e.changeFrequency)}</changefreq>`;
+		if (e.priority !== void 0) xml += `\n    <priority>${e.priority}</priority>`;
+		xml += "\n  </url>";
+		return xml;
+	}).join("\n")}\n</urlset>`;
+}
+/** Escape special XML characters. */
+function escapeXml(str) {
+	return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+//#endregion
+//#region src/server/pipeline-interception.ts
+/**
+* Interception route matching for the request pipeline.
+*
+* Matches target URLs against interception rewrites to support the
+* modal route pattern (soft navigation intercepts).
+*
+* Extracted from pipeline.ts to keep files under 500 lines.
+*
+* See design/07-routing.md §"Intercepting Routes"
+*/
+/**
+* Check if a pathname starts with a prefix on a segment boundary.
+*
+* Prevents /feed from matching /feed-private — the prefix must be
+* followed by '/' or be an exact match.
+*/
+function hasSegmentPrefix(pathname, prefix) {
+	if (prefix === "/") return true;
+	if (!pathname.startsWith(prefix)) return false;
+	return pathname.length === prefix.length || pathname[prefix.length] === "/";
+}
+/**
+* Check if an intercepting route applies for this soft navigation.
+*
+* Matches the target pathname against interception rewrites, constrained
+* by the source URL (X-Timber-URL header — where the user navigates FROM).
+*
+* Returns the source pathname to re-match if interception applies, or null.
+*/
+function findInterceptionMatch(targetPathname, sourceUrl, rewrites) {
+	for (const rewrite of rewrites) {
+		if (!hasSegmentPrefix(sourceUrl, rewrite.interceptingPrefix)) continue;
+		if (pathnameMatchesPattern(targetPathname, rewrite.interceptedPattern)) return { sourcePathname: rewrite.interceptingPrefix };
+	}
+	return null;
+}
+/**
+* Check if a pathname matches a URL pattern with dynamic segments.
+*
+* Supports [param] (single segment) and [...param] (one or more segments).
+* Static segments must match exactly.
+*/
+function pathnameMatchesPattern(pathname, pattern) {
+	const pathParts = pathname === "/" ? [] : pathname.slice(1).split("/");
+	const patternParts = pattern === "/" ? [] : pattern.slice(1).split("/");
+	let pi = 0;
+	for (let i = 0; i < patternParts.length; i++) {
+		const seg = classifyUrlSegment(patternParts[i]);
+		switch (seg.kind) {
+			case "catch-all": return pi < pathParts.length;
+			case "optional-catch-all": return true;
+			case "dynamic":
+				if (pi >= pathParts.length) return false;
+				pi++;
+				continue;
+			case "static":
+				if (pi >= pathParts.length || pathParts[pi] !== seg.value) return false;
+				pi++;
+				continue;
+		}
+	}
+	return pi === pathParts.length;
+}
+//#endregion
+//#region src/server/pipeline-outcome.ts
+/**
+* Pipeline outcome translator — converts a `PhaseOutcome` (the value
+* each phase function returns) into a final `Response`.
+*
+* Lifted out of `pipeline-phases.ts` (TIM-853) so the per-phase try /
+* catch logic and the terminal Response-building logic each live in
+* their own file. The phases produce values; this module is the single
+* source of truth for how those values become wire responses.
+*
+* See design/07-routing.md §"Request Lifecycle".
+*/
+function rscErrorResponse(isRsc, status, headers) {
+	if (!isRsc) return new Response(null, { status });
+	const h = headers ?? new Headers();
+	h.set("X-Timber-Error", "1");
+	h.set("content-type", "application/json; charset=utf-8");
+	return new Response(JSON.stringify({
+		error: true,
+		status
+	}), {
+		status,
+		headers: h
+	});
+}
+/**
+* Terminal outcome handler — converts a `PhaseOutcome` into a final
+* `Response`, applying cookies, building redirects, rendering deny pages
+* and fallback error pages, and firing instrumentation hooks.
+*
+* This is the single source of truth for how phase outputs become wire
+* responses; the per-phase try/catch blocks now produce values, not
+* Responses, so the conversion logic lives in exactly one place.
+*/
+async function outcomeToResponse(config, outcome, ctx) {
+	switch (outcome.kind) {
+		case "response": {
+			const finalResponse = cloneWithMutableHeaders(outcome.response);
+			if (outcome.phase === "proxy") return finalResponse;
+			if (outcome.phase === "middleware" && ctx.responseHeaders) {
+				applyCookieJar(finalResponse.headers);
+				mergeMissingHeaders(finalResponse.headers, ctx.responseHeaders);
+				logMiddlewareShortCircuit({
+					method: ctx.method,
+					path: ctx.path,
+					status: finalResponse.status
+				});
+			}
+			if (outcome.phase === "render") markResponseFlushed();
+			return finalResponse;
+		}
+		case "redirect": {
+			const headers = ctx.responseHeaders ?? new Headers();
+			applyCookieJar(headers);
+			return buildRedirectResponse(outcome.signal, ctx.req, headers);
+		}
+		case "deny": {
+			const headers = ctx.responseHeaders ?? new Headers();
+			applyCookieJar(headers);
+			if (config.renderDenyFallback) try {
+				return cloneWithMutableHeaders(await config.renderDenyFallback(outcome.signal, ctx.req, headers, ctx.match));
+			} catch (denyRenderError) {
+				logRenderError({
+					method: ctx.method,
+					path: ctx.path,
+					error: denyRenderError
+				});
+				await fireOnRequestError(denyRenderError, ctx.req, "render");
+				if (config.onPipelineError && denyRenderError instanceof Error) config.onPipelineError(denyRenderError, "render");
+			}
+			if (isDebug()) console.warn(`[timber] DenySignal(${outcome.signal.status}) from ${outcome.phase} phase — no renderDenyFallback configured, returning bare ${outcome.signal.status} response\n  Request: ${ctx.method} ${ctx.path}\n  Add a not-found.tsx or error.tsx to render a custom deny page.`);
+			return new Response(null, {
+				status: outcome.signal.status,
+				headers
+			});
+		}
+		case "error": {
+			const isRsc = (ctx.req.headers.get("Accept") ?? "").includes("text/x-component");
+			if (outcome.phase === "proxy") {
+				logProxyError({ error: outcome.error });
+				await fireOnRequestError(outcome.error, ctx.req, "proxy");
+				if (config.onPipelineError && outcome.error instanceof Error) config.onPipelineError(outcome.error, "proxy");
+				return rscErrorResponse(isRsc, 500);
+			}
+			if (outcome.phase === "middleware") {
+				logMiddlewareError({
+					method: ctx.method,
+					path: ctx.path,
+					error: outcome.error
+				});
+				await fireOnRequestError(outcome.error, ctx.req, "handler");
+				if (config.onPipelineError && outcome.error instanceof Error) config.onPipelineError(outcome.error, "middleware");
+				return rscErrorResponse(isRsc, 500);
+			}
+			const headers = ctx.responseHeaders ?? new Headers();
+			applyCookieJar(headers);
+			logRenderError({
+				method: ctx.method,
+				path: ctx.path,
+				error: outcome.error
+			});
+			await fireOnRequestError(outcome.error, ctx.req, "render");
+			if (config.onPipelineError && outcome.error instanceof Error) config.onPipelineError(outcome.error, "render");
+			if (isRsc) return rscErrorResponse(true, 500, headers);
+			if (config.renderFallbackError) try {
+				return cloneWithMutableHeaders(await config.renderFallbackError(outcome.error, ctx.req, headers));
+			} catch (fallbackRenderError) {
+				logRenderError({
+					method: ctx.method,
+					path: ctx.path,
+					error: fallbackRenderError
+				});
+				await fireOnRequestError(fallbackRenderError, ctx.req, "render");
+				if (config.onPipelineError && fallbackRenderError instanceof Error) config.onPipelineError(fallbackRenderError, "render");
+			}
+			return new Response(null, { status: 500 });
+		}
+	}
+}
+//#endregion
+//#region src/server/pipeline-phases.ts
+/**
+* Pipeline phase functions — module-level free functions that take their
+* dependencies as explicit parameters. Each phase returns a `PhaseOutcome`
+* (a discriminated union over response / redirect / deny / error) defined
+* in `pipeline-outcome.ts`. The terminal `outcomeToResponse` (also in
+* `pipeline-outcome.ts`) translates outcomes into Responses.
+*
+* Lifted out of `createPipeline` so each phase can be unit-tested in
+* isolation. The lift is mechanical — these functions used to be closures
+* over `config`; they now take `config` as an explicit parameter.
+*
+* See design/07-routing.md §"Request Lifecycle", design/02-rendering-pipeline.md §"Request Flow".
+*/
+/**
+* Validate and canonicalize the X-Timber-URL header value.
+*
+* Returns the canonical pathname if valid, or null if rejected:
+* - Must start with '/' (relative pathname, no scheme/authority)
+* - Must not contain control characters
+* - Must pass canonicalization (no encoded separators, null bytes, etc.)
+*/
+function validateInterceptionHeader(raw, stripTrailingSlash) {
+	if (!raw.startsWith("/")) return null;
+	if (raw.startsWith("//")) return null;
+	for (let i = 0; i < raw.length; i++) {
+		const code = raw.charCodeAt(i);
+		if (code <= 31 || code === 127) return null;
+	}
+	const result = canonicalize(raw, stripTrailingSlash);
+	if (!result.ok) return null;
+	return result.pathname;
+}
+/**
+* Run the proxy.ts phase. Calls user proxy code and uses `handleRequest` as
+* the inner `next()` continuation. The proxy resolver was picked at pipeline
+* construction time so the hot path sees no per-request branching on the
+* `ProxyConfig` discriminant.
+*/
+async function runProxyPhase(config, getProxy, req, method, path) {
+	const detailed = config.serverTiming === "detailed";
+	try {
+		const proxyExport = await getProxy();
+		const proxyFn = () => runProxy(proxyExport, req, () => handleRequest(config, req, method, path, true));
+		return {
+			kind: "response",
+			phase: "proxy",
+			response: await withSpan("timber.proxy", {}, () => detailed ? withTiming("proxy", "proxy.ts", proxyFn) : proxyFn())
+		};
+	} catch (error) {
+		if (error instanceof RedirectSignal) return {
+			kind: "redirect",
+			phase: "proxy",
+			signal: error
+		};
+		if (error instanceof DenySignal) return {
+			kind: "deny",
+			phase: "proxy",
+			signal: error
+		};
+		return {
+			kind: "error",
+			phase: "proxy",
+			error
+		};
+	}
+}
+/**
+* Run the middleware chain phase. If the chain short-circuits with a Response,
+* returns it as a 'response' outcome. Otherwise applies the request header
+* overlay and falls through to the render phase.
+*/
+async function runMiddlewarePhase(config, req, match, responseHeaders, requestHeaderOverlay, renderContext) {
+	const detailed = config.serverTiming === "detailed";
+	const ctx = {
+		req,
+		requestHeaders: requestHeaderOverlay,
+		headers: responseHeaders,
+		segmentParams: match.segmentParams,
+		earlyHints: (hints) => {
+			for (const hint of hints) {
+				let value;
+				if (hint.as !== void 0) value = `<${hint.href}>; as=${hint.as}; rel=${hint.rel}`;
+				else value = `<${hint.href}>; rel=${hint.rel}`;
+				if (hint.crossOrigin !== void 0) value += `; crossorigin=${hint.crossOrigin}`;
+				if (hint.fetchPriority !== void 0) value += `; fetchpriority=${hint.fetchPriority}`;
+				responseHeaders.append("Link", value);
+			}
+		}
+	};
+	try {
+		const chainFn = () => runMiddlewareChain(match.middlewareChain, ctx);
+		const middlewareResponse = await (async () => {
+			setMutableCookieContext(true);
+			try {
+				return await withSpan("timber.middleware", {}, () => detailed ? withTiming("mw", "middleware.ts", chainFn) : chainFn());
+			} finally {
+				setMutableCookieContext(false);
+			}
+		})();
+		if (middlewareResponse) return {
+			kind: "response",
+			phase: "middleware",
+			response: middlewareResponse
+		};
+		applyRequestHeaderOverlay(requestHeaderOverlay);
+		applyCookieJar(responseHeaders);
+		return runRenderPhase(config, req, match, responseHeaders, requestHeaderOverlay, renderContext);
+	} catch (error) {
+		if (error instanceof RedirectSignal) return {
+			kind: "redirect",
+			phase: "middleware",
+			signal: error
+		};
+		if (error instanceof DenySignal) return {
+			kind: "deny",
+			phase: "middleware",
+			signal: error
+		};
+		return {
+			kind: "error",
+			phase: "middleware",
+			error
+		};
+	}
+}
+/**
+* Run the render phase. Wraps the configured renderer in a span and a
+* timing scope, and translates thrown signals into outcome variants.
+*/
+async function runRenderPhase(config, req, match, responseHeaders, requestHeaderOverlay, { canonicalPathname, interception }) {
+	const detailed = config.serverTiming === "detailed";
+	try {
+		const renderFn = () => config.render(req, match, responseHeaders, requestHeaderOverlay, interception);
+		return {
+			kind: "response",
+			phase: "render",
+			response: await withSpan("timber.render", { "http.route": canonicalPathname }, () => detailed ? withTiming("render", "RSC + SSR render", renderFn) : renderFn())
+		};
+	} catch (error) {
+		if (error instanceof DenySignal) return {
+			kind: "deny",
+			phase: "render",
+			signal: error
+		};
+		if (error instanceof RedirectSignal) return {
+			kind: "redirect",
+			phase: "render",
+			signal: error
+		};
+		return {
+			kind: "error",
+			phase: "render",
+			error
+		};
+	}
+}
+/**
+* Process a single request from canonicalization through phase dispatch.
+*
+* Stages: canonicalize → metadata routes → auto-sitemap → version skew →
+* route match → interception → early hints → param coercion → middleware →
+* render → outcome translation. Pre-routing short-circuits return Responses
+* directly; post-match dispatch goes through `outcomeToResponse`.
+*
+* Used both as the top-level entry (when no proxy.ts is configured) and as
+* the `next()` continuation passed to `runProxy()`.
+*
+* @param pathIsCanonical When true, `path` has already been canonicalized by
+*   `createPipeline` — skip re-canonicalization to prevent double-decode.
+*   When false (default), runs canonicalize as a safety net for direct callers.
+*/
+async function handleRequest(config, req, method, path, pathIsCanonical) {
+	const stripTrailingSlash = config.stripTrailingSlash ?? true;
+	let canonicalPathname;
+	if (pathIsCanonical) canonicalPathname = path;
+	else {
+		const result = canonicalize(path, stripTrailingSlash);
+		if (!result.ok) {
+			if (isDebug()) console.warn(`[timber] URL canonicalization rejected ${method} ${path} — responding with ${result.status}\n  This usually means the URL contains encoded separators (%2f, %5c),\n  null bytes (%00), path traversal (..), or malformed percent-encoding.`);
+			return new Response(null, { status: result.status });
+		}
+		canonicalPathname = result.pathname;
+	}
+	if (config.matchMetadataRoute) {
+		const metaMatch = config.matchMetadataRoute(canonicalPathname);
+		if (metaMatch) try {
+			if (metaMatch.isStatic) return await serveStaticMetadataFile(metaMatch);
+			setSegmentParams(metaMatch.segmentParams);
+			const mod = await loadModule(metaMatch.file);
+			if (typeof mod.default !== "function") {
+				if (isDebug()) console.warn(`[timber] Metadata route ${metaMatch.file} does not export a default function — responding with 500\n  Metadata routes must export a default function that returns the metadata content.`);
+				return new Response("Metadata route must export a default function", { status: 500 });
+			}
+			const handlerResult = await mod.default();
+			if (handlerResult instanceof Response) {
+				if (method === "HEAD") {
+					const headHeaders = new Headers(handlerResult.headers);
+					if (handlerResult.ok && !headHeaders.has("Cache-Control")) headHeaders.set("Cache-Control", "public, max-age=14400, must-revalidate");
+					return new Response(null, {
+						status: handlerResult.status,
+						statusText: handlerResult.statusText,
+						headers: headHeaders
+					});
+				}
+				const res = cloneWithMutableHeaders(handlerResult);
+				if (res.ok && !res.headers.has("Cache-Control")) res.headers.set("Cache-Control", "public, max-age=14400, must-revalidate");
+				return res;
+			}
+			const contentType = metaMatch.contentType;
+			let body;
+			if (typeof handlerResult === "string") body = handlerResult;
+			else if (contentType === "application/xml") body = serializeSitemap(handlerResult);
+			else if (contentType === "application/manifest+json") body = JSON.stringify(handlerResult, null, 2);
+			else body = String(handlerResult);
+			return new Response(body, {
+				status: 200,
+				headers: {
+					"Content-Type": `${contentType}; charset=utf-8`,
+					"Cache-Control": "public, max-age=14400, must-revalidate"
+				}
+			});
+		} catch (error) {
+			if (error instanceof RedirectSignal) return new Response(null, {
+				status: error.status,
+				headers: { Location: error.location }
+			});
+			if (error instanceof DenySignal) return new Response(null, { status: error.status });
+			logRenderError({
+				method,
+				path,
+				error
+			});
+			if (config.onPipelineError && error instanceof Error) config.onPipelineError(error, "metadata-route");
+			return new Response(null, { status: 500 });
+		}
+	}
+	if (config.autoSitemapHandler) try {
+		const sitemapResponse = await config.autoSitemapHandler(canonicalPathname);
+		if (sitemapResponse) return cloneWithMutableHeaders(sitemapResponse);
+	} catch (error) {
+		logRenderError({
+			method,
+			path,
+			error
+		});
+		if (config.onPipelineError && error instanceof Error) config.onPipelineError(error, "auto-sitemap");
+		return new Response(null, { status: 500 });
+	}
+	const isRscRequest = (req.headers.get("Accept") ?? "").includes("text/x-component");
+	if (isRscRequest) {
+		if (!checkVersionSkew(req).ok) {
+			const reloadHeaders = new Headers();
+			applyReloadHeaders(reloadHeaders);
+			return new Response(null, {
+				status: 204,
+				headers: reloadHeaders
+			});
+		}
+	}
+	let match = config.matchRoute(canonicalPathname);
+	let interception;
+	if (isRscRequest && config.interceptionRewrites?.length) {
+		const rawSourceUrl = req.headers.get("X-Timber-URL");
+		const validatedSourceUrl = rawSourceUrl ? validateInterceptionHeader(rawSourceUrl, stripTrailingSlash) : null;
+		if (validatedSourceUrl) {
+			const intercepted = findInterceptionMatch(canonicalPathname, validatedSourceUrl, config.interceptionRewrites);
+			if (intercepted) {
+				const sourceMatch = config.matchRoute(intercepted.sourcePathname);
+				if (sourceMatch) {
+					match = sourceMatch;
+					interception = { targetPathname: canonicalPathname };
+				}
+			}
+		}
+	}
+	if (!match) {
+		if (isDebug()) console.warn(`[timber] No route matched for pathname: ${canonicalPathname}\n  Input path: ${path}\n  Method: ${method}`);
+		if (config.renderNoMatch) {
+			const responseHeaders = new Headers();
+			return cloneWithMutableHeaders(await config.renderNoMatch(req, responseHeaders));
+		}
+		return new Response(null, { status: 404 });
+	}
+	const responseHeaders = new Headers();
+	const requestHeaderOverlay = new Headers();
+	responseHeaders.set("Cache-Control", "private, no-cache, no-store, max-age=0, must-revalidate");
+	if (config.earlyHints) try {
+		await config.earlyHints(match, req, responseHeaders);
+	} catch (err) {
+		swallow(err, "early hints hook threw");
+	}
+	match.rawSegmentParams = { ...match.segmentParams };
+	try {
+		await coerceSegmentParams(match);
+	} catch (error) {
+		if (error instanceof ParamCoercionError) {
+			if (isDebug()) {
+				const segmentChain = match.segments.map((s) => s.segmentName || "/").join(" → ");
+				console.warn(`[timber] Param coercion failed for ${method} ${canonicalPathname} — responding with 404\n  Matched segments: ${segmentChain}\n  Error: ${error.message}\n  This usually means a params.ts codec rejected the URL params.\n  Check that all fields in defineSegmentParams() are optional for params\n  that don't appear at every route depth (e.g. year, month, day).`);
+			}
+			const leafSegment = match.segments[match.segments.length - 1];
+			if (leafSegment.route && !leafSegment.page) return new Response(null, { status: 404 });
+			if (config.renderNoMatch) return cloneWithMutableHeaders(await config.renderNoMatch(req, responseHeaders));
+			return new Response(null, { status: 404 });
+		}
+		throw error;
+	}
+	setSegmentParams(match.segmentParams);
+	const segmentPath = match.segments.map((s) => s.segmentName).filter(Boolean).join("/") || "/";
+	setMatchedSegmentPath(segmentPath.startsWith("/") ? segmentPath : `/${segmentPath}`);
+	return outcomeToResponse(config, !shouldBypassMiddleware(req) && match.middlewareChain.length > 0 ? await runMiddlewarePhase(config, req, match, responseHeaders, requestHeaderOverlay, {
+		canonicalPathname,
+		interception
+	}) : await runRenderPhase(config, req, match, responseHeaders, requestHeaderOverlay, {
+		canonicalPathname,
+		interception
+	}), {
+		req,
+		method,
+		path,
+		responseHeaders,
+		match
+	});
+}
+//#endregion
+//#region src/server/pipeline.ts
+/**
+* Create the request handler from a pipeline configuration.
+*
+* Returns a function that processes an incoming Request through all pipeline
+* stages and produces a Response. This is the top-level entry point for the
+* server. The body is intentionally small — phase logic lives in
+* `pipeline-phases.ts`. This function only owns the per-request setup that
+* has to wrap the entire dispatch: trace ID, request context ALS, span
+* scope, Server-Timing header emission, and the active-request counter.
+*/
+function createPipeline(config) {
+	const proxyResolver = makeProxyResolver(config.proxy);
+	const slowRequestMs = config.slowRequestMs ?? 3e3;
+	const serverTiming = config.serverTiming ?? "total";
+	let activeRequests = 0;
+	return async (req) => {
+		const url = new URL(req.url);
+		const method = req.method;
+		const path = url.pathname;
+		const startTime = performance.now();
+		activeRequests++;
+		return runWithTraceId(generateTraceId(), async () => {
+			return runWithRequestContext(req, async () => {
+				const runRequest = async () => {
+					logRequestReceived({
+						method,
+						path
+					});
+					const response = await withSpan("http.server.request", {
+						"http.request.method": method,
+						"url.path": path
+					}, async () => {
+						const otelIds = await getOtelTraceId();
+						if (otelIds) replaceTraceId(otelIds.traceId, otelIds.spanId);
+						const stripTrailingSlash = config.stripTrailingSlash ?? true;
+						const canonResult = canonicalize(url.pathname, stripTrailingSlash);
+						if (!canonResult.ok) {
+							if (isDebug()) console.warn(`[timber] URL canonicalization rejected ${method} ${url.pathname} — responding with ${canonResult.status}\n  This usually means the URL contains encoded separators (%2f, %5c),\n  null bytes (%00), path traversal (..), or malformed percent-encoding.`);
+							return new Response(null, { status: canonResult.status });
+						}
+						const canonicalPath = canonResult.pathname;
+						let canonicalReq = req;
+						if (url.pathname !== canonicalPath) {
+							const canonicalUrl = new URL(req.url);
+							canonicalUrl.pathname = canonicalPath;
+							canonicalReq = new Request(canonicalUrl.toString(), req);
+						}
+						let result;
+						if (proxyResolver) result = await outcomeToResponse(config, await runProxyPhase(config, proxyResolver, canonicalReq, method, canonicalPath), {
+							req: canonicalReq,
+							method,
+							path: canonicalPath
+						});
+						else result = await handleRequest(config, canonicalReq, method, canonicalPath, true);
+						await setSpanAttribute("http.response.status_code", result.status);
+						const varyTokens = ["Accept"];
+						if (config.interceptionRewrites?.length) varyTokens.push("X-Timber-URL");
+						const existingVary = result.headers.get("Vary");
+						const existingTokens = existingVary ? existingVary.toLowerCase().split(",").map((t) => t.trim()) : [];
+						const newTokens = varyTokens.filter((t) => !existingTokens.includes(t.toLowerCase()));
+						if (newTokens.length > 0) result.headers.set("Vary", existingVary ? `${existingVary}, ${newTokens.join(", ")}` : newTokens.join(", "));
+						if (serverTiming === "detailed") {
+							const timingHeader = getServerTimingHeader();
+							if (timingHeader) result.headers.set("Server-Timing", timingHeader);
+						} else if (serverTiming === "total") {
+							const totalMs = Math.round(performance.now() - startTime);
+							result.headers.set("Server-Timing", `total;dur=${totalMs}`);
+						}
+						if (serverTiming === "detailed" && result.body) result = new Response(wrapResponseWithStreamTiming(result.body, startTime), {
+							status: result.status,
+							statusText: result.statusText,
+							headers: result.headers
+						});
+						return result;
+					});
+					const durationMs = Math.round(performance.now() - startTime);
+					const status = response.status;
+					const concurrency = activeRequests;
+					activeRequests--;
+					logRequestCompleted({
+						method,
+						path,
+						status,
+						durationMs,
+						concurrency
+					});
+					if (slowRequestMs > 0 && durationMs > slowRequestMs) logSlowRequest({
+						method,
+						path,
+						durationMs,
+						threshold: slowRequestMs,
+						concurrency
+					});
+					return response;
+				};
+				return serverTiming === "detailed" ? runWithTimingCollector(runRequest) : runRequest();
+			});
+		});
+	};
+}
+//#endregion
+//#region src/server/build-manifest.ts
+/**
+* Collect all CSS files needed for a matched route's segment chain.
+*
+* Walks segments root → leaf, collecting CSS for each layout and page.
+* Deduplicates while preserving order (root layout CSS first).
+*/
+function collectRouteCss(segments, manifest) {
+	const seen = /* @__PURE__ */ new Set();
+	const result = [];
+	for (const segment of segments) for (const file of [segment.layout, segment.page]) {
+		if (!file) continue;
+		const cssFiles = manifest.css[file.filePath];
+		if (!cssFiles) continue;
+		for (const url of cssFiles) if (!seen.has(url)) {
+			seen.add(url);
+			result.push(url);
+		}
+	}
+	return result;
+}
+/**
+* Collect all font entries needed for a matched route's segment chain.
+*
+* Walks segments root → leaf, collecting fonts for each layout and page.
+* Deduplicates by href while preserving order.
+*/
+function collectRouteFonts(segments, manifest) {
+	const seen = /* @__PURE__ */ new Set();
+	const result = [];
+	for (const segment of segments) for (const file of [segment.layout, segment.page]) {
+		if (!file) continue;
+		const fonts = manifest.fonts[file.filePath];
+		if (!fonts) continue;
+		for (const entry of fonts) if (!seen.has(entry.href)) {
+			seen.add(entry.href);
+			result.push(entry);
+		}
+	}
+	return result;
+}
+/**
+* Collect modulepreload URLs for a matched route's segment chain.
+*
+* Walks segments root → leaf, collecting transitive JS dependencies
+* for each layout and page. Deduplicates across segments.
+*/
+function collectRouteModulepreloads(segments, manifest) {
+	const seen = /* @__PURE__ */ new Set();
+	const result = [];
+	for (const segment of segments) for (const file of [segment.layout, segment.page]) {
+		if (!file) continue;
+		const preloads = manifest.modulepreload[file.filePath];
+		if (!preloads) continue;
+		for (const url of preloads) if (!seen.has(url)) {
+			seen.add(url);
+			result.push(url);
+		}
+	}
+	return result;
+}
+//#endregion
+//#region src/server/early-hints.ts
+/**
+* 103 Early Hints utilities.
+*
+* Early Hints are sent before the final response to let the browser
+* start fetching critical resources (CSS, fonts, JS) while the server
+* is still rendering.
+*
+* The framework collects hints from two sources:
+* 1. Build manifest — CSS, fonts, and JS chunks known at route-match time
+* 2. ctx.earlyHints() — explicit hints added by middleware or route handlers
+*
+* Both are emitted as Link headers. Cloudflare CDN automatically converts
+* Link headers into 103 Early Hints responses.
+*
+* Design docs: 02-rendering-pipeline.md §"Early Hints (103)"
+*/
+/**
+* Format a single EarlyHint as a Link header value.
+*
+* Attribute order: `as` before `rel` to match Cloudflare CDN's cached
+* Early Hints format. Cloudflare caches Link headers from 200 responses
+* and re-emits them as 103 Early Hints on subsequent requests. If our
+* attribute order differs from Cloudflare's cached copy, the browser
+* sees two preload headers for the same URL (different attribute order)
+* and warns "Preload was ignored." Matching the order ensures the
+* browser deduplicates them correctly.
+*
+* Examples:
+*   `</styles/root.css>; as=style; rel=preload`
+*   `</fonts/inter.woff2>; as=font; rel=preload; crossorigin=anonymous`
+*   `</_timber/client.js>; rel=modulepreload`
+*   `<https://fonts.googleapis.com>; rel=preconnect`
+*/
+function formatLinkHeader(hint) {
+	if (hint.as !== void 0) {
+		let value = `<${hint.href}>; as=${hint.as}; rel=${hint.rel}`;
+		if (hint.crossOrigin !== void 0) value += `; crossorigin=${hint.crossOrigin}`;
+		if (hint.fetchPriority !== void 0) value += `; fetchpriority=${hint.fetchPriority}`;
+		return value;
+	}
+	let value = `<${hint.href}>; rel=${hint.rel}`;
+	if (hint.crossOrigin !== void 0) value += `; crossorigin=${hint.crossOrigin}`;
+	if (hint.fetchPriority !== void 0) value += `; fetchpriority=${hint.fetchPriority}`;
+	return value;
+}
+/**
+* Collect all Link header strings for a matched route's segment chain.
+*
+* Walks the build manifest to emit hints for:
+* - CSS stylesheets (as=style; rel=preload)
+* - Font assets (as=font; rel=preload; crossorigin)
+* - JS modulepreload hints (rel=modulepreload) — unless skipJs is set
+*
+* Returns formatted Link header strings, deduplicated by URL, root → leaf order.
+* Returns an empty array in dev mode (manifest is empty).
+*/
+function collectEarlyHintHeaders(segments, manifest, options) {
+	const result = [];
+	const seenUrls = /* @__PURE__ */ new Set();
+	const add = (url, header) => {
+		if (!seenUrls.has(url)) {
+			seenUrls.add(url);
+			result.push(header);
+		}
+	};
+	for (const url of collectRouteCss(segments, manifest)) add(url, formatLinkHeader({
+		href: url,
+		rel: "preload",
+		as: "style"
+	}));
+	for (const font of collectRouteFonts(segments, manifest)) add(font.href, formatLinkHeader({
+		href: font.href,
+		rel: "preload",
+		as: "font",
+		crossOrigin: "anonymous"
+	}));
+	if (!options?.skipJs) for (const url of collectRouteModulepreloads(segments, manifest)) add(url, formatLinkHeader({
+		href: url,
+		rel: "modulepreload"
+	}));
+	return result;
+}
+//#endregion
+//#region src/server/early-hints-sender.ts
+/**
+* Per-request 103 Early Hints sender — ALS bridge for platform adapters.
+*
+* The pipeline collects Link headers for CSS, fonts, and JS chunks at
+* route-match time. On platforms that support it (Node.js v18.11+, Bun),
+* the adapter can send these as a 103 Early Hints interim response before
+* the final response is ready.
+*
+* This module provides an ALS-based bridge: the generated entry point
+* (e.g., the Nitro entry) wraps the handler with `runWithEarlyHintsSender`,
+* binding a per-request sender function. The pipeline calls
+* `sendEarlyHints103()` to fire the 103 if a sender is available.
+*
+* On platforms where 103 is handled at the CDN level (e.g., Cloudflare
+* converts Link headers into 103 automatically), no sender is installed
+* and `sendEarlyHints103()` is a no-op.
+*
+* Design doc: 02-rendering-pipeline.md §"Early Hints (103)"
+*/
+/**
+* Run a function with a per-request early hints sender installed.
+*
+* Called by generated entry points (e.g., Nitro node-server/bun) to
+* bind the platform's writeEarlyHints capability for the request duration.
+*/
+function runWithEarlyHintsSender(sender, fn) {
+	return earlyHintsSenderAls.run(sender, fn);
+}
+/**
+* Send collected Link headers as a 103 Early Hints response.
+*
+* No-op if no sender is installed for the current request (e.g., on
+* Cloudflare where the CDN handles 103 automatically, or in dev mode).
+*
+* Non-fatal: errors from the sender are caught and silently ignored.
+*/
+function sendEarlyHints103(links) {
+	if (!links.length) return;
+	const sender = earlyHintsSenderAls.getStore();
+	if (!sender) return;
+	try {
+		sender(links);
+	} catch (err) {
+		swallow(err, "early hints 103 send failed");
+	}
+}
+//#endregion
+//#region src/server/tree-builder.ts
+var REACT_COMPONENT_TYPE_MARKERS = /* @__PURE__ */ new Set([
+	Symbol.for("react.forward_ref"),
+	Symbol.for("react.memo"),
+	Symbol.for("react.lazy"),
+	Symbol.for("react.provider"),
+	Symbol.for("react.context"),
+	Symbol.for("react.suspense"),
+	Symbol.for("react.suspense_list"),
+	Symbol.for("react.client.reference")
+]);
+/**
+* Validate that a loaded module's `default` export is something React
+* accepts as the first argument to `createElement` — i.e. a valid component
+* type. React doesn't export `isValidElementType` (only `isValidElement`,
+* which checks for *elements*, not *component types*), so this mirrors
+* React's internal check:
+*
+*   - functions  → function or class components
+*   - objects with a `$$typeof` matching one of React's known component
+*     markers → exotic components (`memo`, `forwardRef`, `lazy`, context,
+*     suspense, client references via `@vitejs/plugin-rsc`)
+*
+* Strings (HTML tag names) are valid for `createElement` but never appear
+* as a route module's default export, so they're not recognized here.
+*
+* Anything else (numbers, plain config objects, JSON, etc.) is rejected so
+* the boundary wrapper is skipped rather than crashing inside React.
+*/
+function isValidElementType(value) {
+	if (typeof value === "function") return true;
+	if (typeof value !== "object" || value === null) return false;
+	const marker = value.$$typeof;
+	return typeof marker === "symbol" && REACT_COMPONENT_TYPE_MARKERS.has(marker);
+}
+/**
+* Build the unified element tree from a matched segment chain.
+*
+* Construction is bottom-up:
+*   1. Start with the page component (leaf segment)
+*   2. Wrap in status-code error boundaries (fallback chain)
+*   3. Wrap in AccessGate (if segment has access.ts)
+*   4. Pass as children to the segment's layout
+*   5. Repeat up the segment chain to root
+*
+* Parallel slots are resolved at each layout level and composed as named props.
+*/
+async function buildElementTree(config) {
+	const { segments, loadModule, createElement, errorBoundaryComponent } = config;
+	if (segments.length === 0) throw new Error("[timber] buildElementTree: empty segment chain");
+	const leaf = segments[segments.length - 1];
+	if (leaf.route && !leaf.page) return {
+		tree: null,
+		isApiRoute: true
+	};
+	const PageComponent = (leaf.page ? await loadModule(leaf.page) : null)?.default;
+	if (!PageComponent) throw new Error(`[timber] No page component found for route at ${leaf.urlPath}. Each route must have a page.tsx or route.ts.`);
+	let element = createElement(PageComponent, {});
+	for (let i = segments.length - 1; i >= 0; i--) {
+		const segment = segments[i];
+		element = await wrapWithErrorBoundaries(segment, element, loadModule, createElement, errorBoundaryComponent);
+		if (segment.access) {
+			const accessFn = (await loadModule(segment.access)).default;
+			element = createElement("timber:access-gate", {
+				accessFn,
+				segmentName: segment.segmentName,
+				children: element
+			});
+		}
+		if (segment.layout) {
+			const LayoutComponent = (await loadModule(segment.layout)).default;
+			if (LayoutComponent) {
+				const slotProps = {};
+				const slotNames = Object.keys(segment.slots);
+				if (slotNames.length > 0) for (const slotName of slotNames) {
+					const slotNode = segment.slots[slotName];
+					slotProps[slotName] = await buildSlotElement(slotNode, loadModule, createElement, errorBoundaryComponent);
+				}
+				element = createElement(LayoutComponent, {
+					...slotProps,
+					children: element
+				});
+			}
+		}
+	}
+	return {
+		tree: element,
+		isApiRoute: false
+	};
+}
+/**
+* Build the element tree for a parallel slot.
+*
+* Slots have their own access.ts (SlotAccessGate) and error boundaries.
+* On access denial: denied.tsx → default.tsx → null (graceful degradation).
+*/
+async function buildSlotElement(slotNode, loadModule, createElement, errorBoundaryComponent) {
+	const PageComponent = (slotNode.page ? await loadModule(slotNode.page) : null)?.default;
+	const DefaultComponent = (slotNode.default ? await loadModule(slotNode.default) : null)?.default;
+	if (!PageComponent) return DefaultComponent ? createElement(DefaultComponent, {}) : null;
+	let element = createElement(PageComponent, {});
+	element = await wrapWithErrorBoundaries(slotNode, element, loadModule, createElement, errorBoundaryComponent);
+	if (slotNode.access) {
+		const accessFn = (await loadModule(slotNode.access)).default;
+		const DeniedComponent = (slotNode.denied ? await loadModule(slotNode.denied) : null)?.default ?? null;
+		const defaultFallback = DefaultComponent ? createElement(DefaultComponent, {}) : null;
+		element = createElement("timber:slot-access-gate", {
+			accessFn,
+			DeniedComponent,
+			slotName: slotNode.segmentName.replace(/^@/, ""),
+			createElement,
+			defaultFallback,
+			children: element
+		});
+	}
+	return element;
+}
+/** MDX/markdown extensions — these are server components that cannot be passed as function props. */
+var MDX_EXTENSIONS = /* @__PURE__ */ new Set(["mdx", "md"]);
+/**
+* Check if a route file is an MDX/markdown file based on its extension.
+* MDX components are server components by default and cannot cross the
+* RSC→client boundary as function props. They must be pre-rendered as
+* elements and passed as fallbackElement instead of fallbackComponent.
+*/
+function isMdxFile(file) {
+	return MDX_EXTENSIONS.has(file.extension);
+}
+/**
+* Wrap an element with error boundaries from a segment's status-code files.
+*
+* Wrapping order (innermost to outermost):
+*   1. Specific status files (503.tsx, 429.tsx, etc.)
+*   2. Category catch-alls (4xx.tsx, 5xx.tsx)
+*   3. error.tsx (general error boundary)
+*
+* This creates the fallback chain described in design/10-error-handling.md.
+*
+* MDX status files are server components and cannot be passed as function
+* props to TimberErrorBoundary (a 'use client' component). Instead, they
+* are pre-rendered as elements and passed as fallbackElement. The error
+* boundary renders the element directly when an error is caught.
+* See TIM-503.
+*/
+async function wrapWithErrorBoundaries(segment, element, loadModule, createElement, errorBoundaryComponent) {
+	if (segment.statusFiles) {
+		for (const [key, file] of Object.entries(segment.statusFiles)) if (key !== "4xx" && key !== "5xx") {
+			const status = parseInt(key, 10);
+			if (!isNaN(status)) {
+				const mod = await loadModule(file);
+				const Component = isValidElementType(mod.default) ? mod.default : null;
+				if (Component) element = createElement(errorBoundaryComponent, isMdxFile(file) ? {
+					fallbackElement: createElement(Component, { status }),
+					status,
+					children: element
+				} : {
+					fallbackComponent: Component,
+					status,
+					children: element
+				});
+			}
+		}
+		for (const [key, file] of Object.entries(segment.statusFiles)) if (key === "4xx" || key === "5xx") {
+			const mod = await loadModule(file);
+			const Component = isValidElementType(mod.default) ? mod.default : null;
+			if (Component) {
+				const categoryStatus = key === "4xx" ? 400 : 500;
+				element = createElement(errorBoundaryComponent, isMdxFile(file) ? {
+					fallbackElement: createElement(Component, {}),
+					status: categoryStatus,
+					children: element
+				} : {
+					fallbackComponent: Component,
+					status: categoryStatus,
+					children: element
+				});
+			}
+		}
+	}
+	if (segment.error) {
+		const errorModule = await loadModule(segment.error);
+		const ErrorComponent = isValidElementType(errorModule.default) ? errorModule.default : null;
+		if (ErrorComponent) element = createElement(errorBoundaryComponent, isMdxFile(segment.error) ? {
+			fallbackElement: createElement(ErrorComponent, {}),
+			children: element
+		} : {
+			fallbackComponent: ErrorComponent,
+			children: element
+		});
+	}
+	return element;
+}
+//#endregion
+//#region src/server/csrf.ts
+/** HTTP methods that are considered safe (no mutation). */
+var SAFE_METHODS = /* @__PURE__ */ new Set([
+	"GET",
+	"HEAD",
+	"OPTIONS"
+]);
+/**
+* Derive the request's scheme from trusted sources.
+*
+* Priority:
+* 1. X-Forwarded-Proto (set by reverse proxies / load balancers)
+* 2. Request URL protocol
+*
+* Falls back to 'https' (fail closed) if neither is available.
+*/
+function deriveRequestScheme(req) {
+	const forwarded = req.headers.get("X-Forwarded-Proto");
+	if (forwarded) {
+		const proto = forwarded.split(",")[0].trim().toLowerCase();
+		if (proto === "http" || proto === "https") return proto;
+	}
+	try {
+		return new URL(req.url).protocol.replace(":", "");
+	} catch {
+		return "https";
+	}
+}
+/**
+* Validate the Origin header against the request's full origin
+* (scheme + host + port).
+*
+* For mutation methods (POST, PUT, PATCH, DELETE):
+* - If `csrf: false`, skip validation.
+* - If `allowedOrigins` is set, Origin must match one exactly (no wildcards).
+* - Otherwise, Origin must match the derived request origin.
+*
+* Safe methods (GET, HEAD, OPTIONS) always pass.
+*/
+function validateCsrf(req, config) {
+	if (SAFE_METHODS.has(req.method)) return { ok: true };
+	if (config.csrf === false) return { ok: true };
+	const origin = req.headers.get("Origin");
+	if (!origin) return {
+		ok: false,
+		status: 403
+	};
+	if (config.allowedOrigins) return config.allowedOrigins.includes(origin) ? { ok: true } : {
+		ok: false,
+		status: 403
+	};
+	const host = req.headers.get("Host");
+	if (!host) return {
+		ok: false,
+		status: 403
+	};
+	let originOrigin;
+	try {
+		originOrigin = new URL(origin).origin;
+	} catch {
+		return {
+			ok: false,
+			status: 403
+		};
+	}
+	const scheme = deriveRequestScheme(req);
+	let expectedOrigin;
+	try {
+		expectedOrigin = new URL(`${scheme}://${host}`).origin;
+	} catch {
+		return {
+			ok: false,
+			status: 403
+		};
+	}
+	return originOrigin === expectedOrigin ? { ok: true } : {
+		ok: false,
+		status: 403
+	};
+}
+//#endregion
+//#region src/server/body-limits.ts
+var KB = 1024;
+var MB = 1024 * KB;
+var GB = 1024 * MB;
+var DEFAULT_LIMITS = {
+	actionBodySize: 1 * MB,
+	uploadBodySize: 10 * MB,
+	maxFields: 100
+};
+var SIZE_PATTERN = /^(\d+(?:\.\d+)?)\s*(kb|mb|gb)?$/i;
+/** Parse a human-readable size string ("1mb", "512kb", "1024") into bytes. */
+function parseBodySize(size) {
+	const match = SIZE_PATTERN.exec(size.trim());
+	if (!match) throw new Error(`Invalid body size format: "${size}". Expected format like "1mb", "512kb", or "1024".`);
+	const value = Number.parseFloat(match[1]);
+	const unit = (match[2] ?? "").toLowerCase();
+	switch (unit) {
+		case "kb": return Math.floor(value * KB);
+		case "mb": return Math.floor(value * MB);
+		case "gb": return Math.floor(value * GB);
+		case "": return Math.floor(value);
+		default: throw new Error(`Unknown size unit: "${unit}"`);
+	}
+}
+/** Strict integer pattern: one or more digits, nothing else. */
+var STRICT_INTEGER_RE = /^\d+$/;
+/** Check whether a request body exceeds the configured size limit (stateless, no ALS). */
+function enforceBodyLimits(req, kind, config) {
+	const contentLength = req.headers.get("Content-Length");
+	if (!contentLength) return {
+		ok: false,
+		status: 411
+	};
+	const trimmed = contentLength.trim();
+	if (!STRICT_INTEGER_RE.test(trimmed)) return {
+		ok: false,
+		status: 411
+	};
+	return Number.parseInt(trimmed, 10) <= resolveLimit(kind, config) ? { ok: true } : {
+		ok: false,
+		status: 413
+	};
+}
+/**
+* Resolve the byte limit for a given body kind, using config overrides or defaults.
+*/
+function resolveLimit(kind, config) {
+	const userLimits = config.limits;
+	if (kind === "action") return userLimits?.actionBodySize ? parseBodySize(userLimits.actionBodySize) : DEFAULT_LIMITS.actionBodySize;
+	return userLimits?.uploadBodySize ? parseBodySize(userLimits.uploadBodySize) : DEFAULT_LIMITS.uploadBodySize;
+}
+//#endregion
+//#region src/server/route-handler.ts
+/** All recognized HTTP method export names. */
+var HTTP_METHODS = [
+	"GET",
+	"POST",
+	"PUT",
+	"PATCH",
+	"DELETE",
+	"HEAD",
+	"OPTIONS"
+];
+/**
+* Resolve the full list of allowed methods for a route module.
+*
+* Includes:
+* - All explicitly exported methods
+* - HEAD (implicit when GET is exported)
+* - OPTIONS (always implicit)
+*/
+function resolveAllowedMethods(mod) {
+	const methods = [];
+	for (const method of HTTP_METHODS) {
+		if (method === "HEAD" || method === "OPTIONS") continue;
+		if (mod[method]) methods.push(method);
+	}
+	if (mod.GET && !mod.HEAD) methods.push("HEAD");
+	else if (mod.HEAD) methods.push("HEAD");
+	if (!mod.OPTIONS) methods.push("OPTIONS");
+	else methods.push("OPTIONS");
+	return methods;
+}
+/**
+* Handle an incoming request against a route.ts module.
+*
+* Dispatches to the named method handler, auto-generates 405/OPTIONS,
+* and merges response headers from ctx.headers.
+*/
+async function handleRouteRequest(mod, ctx) {
+	const method = ctx.req.method.toUpperCase();
+	const allowHeader = resolveAllowedMethods(mod).join(", ");
+	if (method === "OPTIONS") {
+		if (mod.OPTIONS) return runHandler(mod.OPTIONS, ctx);
+		return new Response(null, {
+			status: 204,
+			headers: { Allow: allowHeader }
+		});
+	}
+	if (method === "HEAD") {
+		if (mod.HEAD) return runHandler(mod.HEAD, ctx);
+		if (mod.GET) {
+			const res = await runHandler(mod.GET, ctx);
+			return new Response(null, {
+				status: res.status,
+				headers: res.headers
+			});
+		}
+	}
+	const handler = mod[method];
+	if (!handler) return new Response(null, {
+		status: 405,
+		headers: { Allow: allowHeader }
+	});
+	return runHandler(handler, ctx);
+}
+/**
+* Run a handler, merge ctx.headers into the response, and catch errors.
+*/
+async function runHandler(handler, ctx) {
+	try {
+		return mergeResponseHeaders(await handler(ctx), ctx.headers);
+	} catch (error) {
+		if (error instanceof DenySignal || error instanceof RedirectSignal) throw error;
+		logRouteError({
+			method: ctx.req.method,
+			path: new URL(ctx.req.url).pathname,
+			error
+		});
+		return new Response(null, { status: 500 });
+	}
+}
+/**
+* Merge response headers from ctx.headers into the handler's response.
+* ctx.headers (set by middleware or the handler) are applied to the final response.
+* Handler-set headers take precedence over ctx.headers.
+*/
+function mergeResponseHeaders(res, ctxHeaders) {
+	let hasCtxHeaders = false;
+	ctxHeaders.forEach(() => {
+		hasCtxHeaders = true;
+	});
+	if (!hasCtxHeaders) return res;
+	const merged = new Headers();
+	ctxHeaders.forEach((value, key) => {
+		if (key.toLowerCase() === "set-cookie") merged.append(key, value);
+		else merged.set(key, value);
+	});
+	const resCookies = res.headers.getSetCookie();
+	for (const cookie of resCookies) merged.append("Set-Cookie", cookie);
+	res.headers.forEach((value, key) => {
+		if (key.toLowerCase() !== "set-cookie") merged.set(key, value);
+	});
+	return new Response(res.body, {
+		status: res.status,
+		statusText: res.statusText,
+		headers: merged
+	});
+}
+//#endregion
+//#region src/server/render-timeout.ts
+/**
+* Render timeout utilities for SSR streaming pipeline.
+*
+* Provides a RenderTimeoutError class and a helper to create
+* timeout-guarded AbortSignals. Used to defend against hung RSC
+* streams and infinite SSR renders.
+*
+* Design doc: 02-rendering-pipeline.md §"Streaming Constraints"
+*/
+/**
+* Error thrown when an SSR render or RSC stream read exceeds the
+* configured timeout. Callers can check `instanceof RenderTimeoutError`
+* to distinguish timeout from other errors and return a 504 or close
+* the connection cleanly.
+*/
+var RenderTimeoutError = class extends Error {
+	timeoutMs;
+	constructor(timeoutMs, context) {
+		const message = context ? `Render timeout after ${timeoutMs}ms: ${context}` : `Render timeout after ${timeoutMs}ms`;
+		super(message);
+		this.name = "RenderTimeoutError";
+		this.timeoutMs = timeoutMs;
+	}
+};
+//#endregion
+//#region src/server/prebuilt/cache-key.ts
+/**
+* Component cache-key hashing for prebuilt (cache.component) entries.
+*
+* Key: `sha256(canonicalJson({ props, params })).slice(0, 16)` — see
+* design/44-render-at-build-time.md §Cache Key. Both the request-time
+* lookup (prebuilt-runtime.ts) and the post-build capture pass (TIM-1119)
+* MUST use this exact function, or build artifacts become unaddressable.
+*
+* THE IDENTITY CONTRACT (design/44 §Cache Key): cache identity is **JSON
+* value semantics** — two inputs are the same entry iff they are the same
+* JSON value. This is an ALLOWLIST, not a denylist: a value participates
+* in caching iff it is plain JSON data — null, boolean, finite number,
+* string, dense array, or a plain `Object.prototype` object with only
+* enumerable string-keyed data properties — plus `undefined` and `-0`,
+* which hash as distinct sentinels because flight preserves them. Every
+* value outside that domain (functions, symbols, bigints, accessors,
+* hidden or symbol-keyed properties, non-`Object.prototype` prototypes
+* including null, aliased references, sparse arrays, cycles, non-finite
+* numbers) is UNKEYABLE by definition: `computeComponentCacheKey` returns
+* null and the caller renders live — slower, never wrong.
+*
+* The line between rejected and declared-out-of-domain: values are
+* REJECTED when the JSON projection itself would be ambiguous or lossy
+* (hidden/symbol/non-enumerable properties, accessors, exotic
+* prototypes). Observable state that leaves the projection intact — key
+* order, reference identity, descriptor metadata (writable/configurable,
+* frozen/sealed/extensible), proxy behavior — is DECLARED outside
+* cache.component's supported input domain rather than rejected:
+* key-order insensitivity is required for determinism, and rejecting
+* frozen objects would unkey ubiquitous legitimate inputs
+* (Object.freeze'd config props) to defend against components that
+* render differently based on property attributes.
+*
+* Two hard rules for this walk itself: it must be TOTAL (never throw
+* anything but UnkeyableValueError) and SIDE-EFFECT-FREE (descriptor
+* reads only; never invoke user code such as getters).
+*
+* Object keys sort recursively so `{a, b}` and `{b, a}` hash identically
+* (design/13-security.md checklist #14 — cache key determinism; key order
+* is deliberately NOT part of identity).
+*/
+var UnkeyableValueError = class extends Error {};
+function canonicalize$1(value, seen) {
+	if (value === null) return "null";
+	switch (typeof value) {
+		case "string": return JSON.stringify(value);
+		case "boolean": return value ? "true" : "false";
+		case "number":
+			if (!Number.isFinite(value)) throw new UnkeyableValueError("non-finite number");
+			return Object.is(value, -0) ? "-0" : String(value);
+		case "object": break;
+		case "undefined": return "undefined";
+		default: throw new UnkeyableValueError(`unsupported type: ${typeof value}`);
+	}
+	const obj = value;
+	if (seen.has(obj)) throw new UnkeyableValueError("repeated object reference (cycle or alias)");
+	seen.add(obj);
+	if (Object.getOwnPropertySymbols(obj).length > 0) throw new UnkeyableValueError("symbol-keyed property");
+	{
+		if (Array.isArray(obj)) {
+			if (Object.getOwnPropertyNames(obj).length !== obj.length + 1) throw new UnkeyableValueError("non-index array property");
+			const parts = [];
+			for (let i = 0; i < obj.length; i++) {
+				const desc = Object.getOwnPropertyDescriptor(obj, i);
+				if (desc === void 0) throw new UnkeyableValueError("sparse array hole");
+				if (desc.get !== void 0 || desc.set !== void 0) throw new UnkeyableValueError("accessor property");
+				if (!desc.enumerable) throw new UnkeyableValueError("non-enumerable array element");
+				parts.push(canonicalize$1(desc.value, seen));
+			}
+			return "[" + parts.join(",") + "]";
+		}
+		if (Object.getPrototypeOf(obj) !== Object.prototype) throw new UnkeyableValueError("non-plain object");
+		const keys = Object.keys(obj).sort();
+		if (keys.length !== Object.getOwnPropertyNames(obj).length) throw new UnkeyableValueError("non-enumerable property");
+		const parts = [];
+		for (const key of keys) {
+			const desc = Object.getOwnPropertyDescriptor(obj, key);
+			if (desc.get !== void 0 || desc.set !== void 0) throw new UnkeyableValueError("accessor property");
+			parts.push(JSON.stringify(key) + ":" + canonicalize$1(desc.value, seen));
+		}
+		return "{" + parts.join(",") + "}";
+	}
+}
+/**
+* Canonicalize a single value, or null if it is unkeyable. The ONE
+* definition of "faithfully comparable" — every prebuilt code path that
+* needs value equality (cache keys, slot-param divergence) goes through
+* this, so the unkeyable rules (accessors, hidden props, aliases,
+* bigints, …) live in exactly one place.
+*/
+function tryCanonicalize(value) {
+	try {
+		return canonicalize$1(value, /* @__PURE__ */ new Set());
+	} catch (error) {
+		return toUnkeyable(error);
+	}
+}
+/**
+* Totality by construction: ANY throw from the walk means the input is
+* outside the keyable domain. The walk touches only user-controlled
+* values through reflection ops — and a Proxy trap can throw arbitrary
+* errors from any of them (codex review on PR #835) — so converting only
+* UnkeyableValueError would let hostile/exotic inputs abort a render
+* that plain live rendering would have served fine. Unexpected error
+* types are logged for visibility (they would indicate either a proxy
+* trap or a canonicalizer bug) but still degrade to unkeyable.
+*/
+function toUnkeyable(error) {
+	if (!(error instanceof UnkeyableValueError)) console.error("[timber] cache key canonicalization threw — treating input as unkeyable:", error);
+	return null;
+}
+/**
+* Compute the cache-entry hash for a component render:
+* `sha256({props, params}).slice(0, 16)` over canonical JSON.
+*
+* Returns null when props (or params) contain unkeyable values — the
+* caller must fall back to dynamic rendering.
+*/
+function computeComponentCacheKey(props, params) {
+	let canonical;
+	try {
+		const seen = /* @__PURE__ */ new Set();
+		canonical = "{\"params\":" + canonicalize$1({ ...params }, seen) + ",\"props\":" + canonicalize$1(props, seen) + "}";
+	} catch (error) {
+		return toUnkeyable(error);
+	}
+	return createHash("sha256").update(canonical).digest("hex").slice(0, 16);
+}
+//#endregion
+//#region src/server/prebuilt/capture-state.ts
+/** Thrown by the wrapper when a capture renders its own component. */
+var PrebuiltCaptureCycleError = class extends Error {
+	constructor(componentId) {
+		super(`[timber] cache.component "${componentId}" renders itself (directly or through other components) — prerendering it would recurse forever. Remove the cycle or drop { prerender: true } on this component.`);
+		this.name = "PrebuiltCaptureCycleError";
+	}
+};
+var active = null;
+/**
+* Mark a capture as active. The builder calls this immediately before
+* rendering an entry and MUST pair it with `endCapture()` in a finally.
+*/
+function beginCapture(outerId) {
+	active = {
+		outerId,
+		nested: /* @__PURE__ */ new Map()
+	};
+}
+/**
+* End the active capture and return the wrapped components that rendered
+* inside it (first options object wins per inner ID).
+*/
+function endCapture() {
+	const nested = active?.nested;
+	active = null;
+	if (!nested) return [];
+	return Array.from(nested, ([innerId, options]) => ({
+		innerId,
+		options
+	}));
+}
+/** Whether a build-time capture is currently rendering. */
+function isCaptureActive() {
+	return active !== null;
+}
+/**
+* Called by the `__prebuilt` wrapper on every render. No-op unless a
+* capture is active. Throws `PrebuiltCaptureCycleError` when the wrapper
+* belongs to the component currently being captured.
+*/
+function noteWrapperRender(innerId, options) {
+	if (active === null) return;
+	if (innerId === active.outerId) throw new PrebuiltCaptureCycleError(innerId);
+	if (!active.nested.has(innerId)) active.nested.set(innerId, options);
+}
+//#endregion
+//#region src/server/prebuilt-runtime.ts
+/**
+* Prebuilt component runtime — registration target for the timber-prebuilt
+* transform (plugins/prebuilt.ts) and the request-time half of
+* cache.component (TIM-1140).
+*
+* `cache.component(fn, opts)` call sites are rewritten at build time to
+* `__prebuilt(stableId, fn, opts)` (production) or `__prebuiltDev(name, fn)`
+* (dev). Both are exported via #server-internal — they are framework
+* plumbing, never called by user code directly.
+*
+* Cache hits are served by FLIGHT REVIVAL: the cached `.flight` payload is
+* decoded back into React elements inside the RSC environment with
+* `createFromReadableStream` (the flight client running in the flight
+* server — plugin-rsc wires the server-decode manifest so client
+* references revive as re-serializable reference proxies). The revived
+* element is returned from the wrapper and the outer render re-serializes
+* it like any other subtree. This is the same mechanism as Next.js
+* `"use cache"` (next/src/server/use-cache/use-cache-wrapper.ts).
+*
+* What a hit skips: all user work — data fetching, MDX compilation, the
+* component function itself never runs. What it re-pays: React
+* re-serializes the already-resolved tree (cost proportional to payload
+* size, not to data latency). The alternative — splicing raw payload bytes
+* into the outer stream — avoids re-serialization but requires byte-level
+* coupling to the flight wire format (row framing, ID rebasing, marker
+* detection); it was implemented and reviewed on PR #835 and deliberately
+* replaced by revival. See design/44-render-at-build-time.md
+* §Request-Time Injection.
+*
+* Misses render the original component live via the wrapper's own closure,
+* inside the React pass — segment params from ALS, deny()/redirect()
+* signals, Suspense, and error boundaries behave exactly as an unwrapped
+* component. `fallbackOnMissingSegmentParams: false` throws instead.
+*/
+/** Default timeout for component re-renders (overridden by renderTimeoutMs). */
+var DEFAULT_COMPONENT_TIMEOUT_MS = 3e4;
+/** Singleflight for component re-renders (inline and background). */
+var componentSingleflight = createSingleflight({ timeoutMs: DEFAULT_COMPONENT_TIMEOUT_MS });
+var componentTimeoutMs = DEFAULT_COMPONENT_TIMEOUT_MS;
+var warnedNoWaitUntil = false;
+/**
+* Server-side component registry, keyed by stable component ID. Populated at
+* module load time by `__prebuilt` calls; consumed by the post-build capture
+* pass (TIM-1119). Never serialized — component functions are not
+* Flight-serializable.
+*/
+var registry = /* @__PURE__ */ new Map();
+/**
+* Resolve the params the cache key may faithfully hash, or null if this
+* render is unkeyable.
+*
+* A wrapper rendered inside a parallel slot reads params merged with that
+* slot's overrides (`getSegmentParams`: `{...segmentParams, ...slotParams}`)
+* — but the cache key hashes only the route-level params, and the wrapper
+* cannot know which slot it renders under. The route params are usable
+* only when every slot's merged view canonicalizes identically to them;
+* otherwise two renders with the same key could see different effective
+* inputs and a hit could serve the WRONG cached subtree — so the render
+* goes live: slower, never wrong. (Build-time capture doesn't model slot
+* params either, so a divergent request could never have a faithful
+* entry. Codex review on PR #835; revisit with segment-path-scoped keys
+* if slot-scoped prebuilt is ever needed.)
+*
+* Comparison happens through `tryCanonicalize` — the same single
+* definition of value equality the cache key uses — so anything it
+* cannot represent faithfully (bigint-coerced codec params, accessors,
+* aliases, …) is unkeyable here too, and this guard can never throw.
+*/
+function resolveKeyParams(store) {
+	const main = store.segmentParams ?? {};
+	const map = store.slotParamsMap;
+	if (!map || map.size === 0) return main;
+	const mainCanonical = tryCanonicalize({ ...main });
+	if (mainCanonical === null) return null;
+	for (const slotParams of map.values()) {
+		const merged = tryCanonicalize({
+			...main,
+			...slotParams
+		});
+		if (merged === null || merged !== mainCanonical) return null;
+	}
+	return main;
+}
+/** Wrap payload bytes as a single-chunk ReadableStream for the decoder. */
+function bytesToStream(bytes) {
+	return new ReadableStream({ start(controller) {
+		controller.enqueue(bytes);
+		controller.close();
+	} });
+}
+/** Whether the component has a runtime lifetime (ttl or tags). */
+function hasRuntimeLifetime(options) {
+	return options.ttl !== void 0 || options.tags !== void 0 && options.tags !== null;
+}
+/** Resolve tags from options (may be static array or function of props). */
+function resolveTags(options, props) {
+	if (!options.tags) return [];
+	if (Array.isArray(options.tags)) return options.tags;
+	return options.tags(props);
+}
+var rscFns = null;
+function requireRscFunctions() {
+	if (!rscFns) throw new Error("[timber] RSC functions not wired — setRscFunctions() must be called at boot");
+	return rscFns;
+}
+/**
+* Revive flight payload bytes into a React element.
+* Returns null on any failure (corrupt payload, missing decoder).
+*/
+async function revivePayload(id, payload, outcome) {
+	try {
+		const { createFromReadableStream } = requireRscFunctions();
+		return { element: await createFromReadableStream(bytesToStream(payload)) };
+	} catch (error) {
+		console.error(`[timber] failed to revive prebuilt payload for "${id}" — ${outcome}:`, error);
+		return null;
+	}
+}
+/** Ceiling on component re-render capture (design/13 A2). Uses configured renderTimeoutMs. */
+function getCaptureTimeoutMs() {
+	return componentTimeoutMs;
+}
+var keyDisciplineWarned = /* @__PURE__ */ new Set();
+var REQUEST_CONTEXT_FIELDS = {
+	headers: "headers()",
+	parsedCookies: "cookies()",
+	searchParams: "searchParams"
+};
+/**
+* Wrap a store with a proxy that records per-request field access.
+* The proxy forwards all reads/writes transparently — it only observes.
+*/
+function createKeyDisciplineProxy(store) {
+	const accessedApis = /* @__PURE__ */ new Set();
+	return {
+		proxy: new Proxy(store, { get(target, prop, receiver) {
+			const api = REQUEST_CONTEXT_FIELDS[prop];
+			if (api) accessedApis.add(api);
+			return Reflect.get(target, prop, receiver);
+		} }),
+		accessedApis
+	};
+}
+function emitKeyDisciplineWarning(id, apis) {
+	if (keyDisciplineWarned.has(id)) return;
+	keyDisciplineWarned.add(id);
+	const apiList = Array.from(apis).join(", ");
+	console.warn(`[timber] cache.component key-discipline warning: "${id}" reads ${apiList} but the cache key is computed from props and segment params only. If the output varies by ${apiList}, different users may see each other's cached content. Either pass request-derived values as props (included in the cache key) or remove the ${apiList} call.`);
+}
+/**
+* Render a component in isolation and capture its flight payload bytes.
+* Used for inline re-renders (tombstone/miss) and SWR background re-renders.
+*
+* The stream read is timeout-guarded and the reader is cancelled on
+* expiry (design/13 A2, A3).
+*/
+async function captureComponentPayload(id, component, props) {
+	const { renderToReadableStream } = requireRscFunctions();
+	const element = createElement(component, props);
+	let renderErrored = false;
+	const store = requestContextAls.getStore();
+	const discipline = store && !keyDisciplineWarned.has(id) ? createKeyDisciplineProxy(store) : null;
+	const doCapture = async () => {
+		beginCapture(id);
+		try {
+			const reader = renderToReadableStream(element, { onError() {
+				renderErrored = true;
+				return "";
+			} }).getReader();
+			const chunks = [];
+			let totalLength = 0;
+			const deadline = Date.now() + getCaptureTimeoutMs();
+			try {
+				for (;;) {
+					const remaining = deadline - Date.now();
+					if (remaining <= 0) throw new Error(`[timber] component re-render capture exceeded ${getCaptureTimeoutMs()}ms`);
+					let timer;
+					const { done, value } = await Promise.race([reader.read(), new Promise((_, reject) => {
+						timer = setTimeout(() => reject(/* @__PURE__ */ new Error(`[timber] component re-render stream read timed out`)), remaining);
+					})]);
+					clearTimeout(timer);
+					if (done) break;
+					chunks.push(value);
+					totalLength += value.byteLength;
+				}
+			} finally {
+				reader.cancel().catch(() => {});
+			}
+			if (renderErrored) throw new Error("[timber] component re-render produced error rows — not caching");
+			const result = new Uint8Array(totalLength);
+			let offset = 0;
+			for (const chunk of chunks) {
+				result.set(chunk, offset);
+				offset += chunk.byteLength;
+			}
+			return result;
+		} finally {
+			endCapture();
+		}
+	};
+	const bytes = discipline ? await requestContextAls.run(discipline.proxy, doCapture) : await doCapture();
+	if (discipline && discipline.accessedApis.size > 0) emitKeyDisciplineWarning(id, discipline.accessedApis);
+	return bytes;
+}
+/**
+* Inline re-render: capture flight bytes, store in overlay, revive for
+* the current request. Singleflight-coalesced by overlay key.
+*/
+async function inlineRerender(id, component, props, cacheKey, options, hasSeed, outcome) {
+	const tags = resolveTags(options, props);
+	const oKey = overlayKey(id, cacheKey);
+	const sfKey = `prebuilt:${id}:${cacheKey}\0${lastInvalidationEpochFor(oKey, tags)}`;
+	try {
+		return await revivePayload(id, await componentSingleflight.do(sfKey, async (signal) => {
+			const startEpoch = currentInvalidationEpoch();
+			const bytes = await captureComponentPayload(id, component, props);
+			if (!signal.aborted && hasRuntimeLifetime(options) && !wasInvalidatedSince(startEpoch, oKey, tags)) await storeOverlayEntry(id, cacheKey, bytes, {
+				ttl: options.ttl,
+				tags,
+				hasSeed
+			});
+			return bytes;
+		}), outcome);
+	} catch (error) {
+		console.error(`[timber] cache.component re-render failed for "${id}" — ${outcome}:`, error);
+		return null;
+	}
+}
+/**
+* Snapshot the request context values needed for a background re-render.
+* Creates a FRESH store with copied values — the original ALS store is
+* not referenced after capture.
+*/
+function snapshotRequestContext(store) {
+	return {
+		headers: new Headers(store.headers),
+		originalHeaders: new Headers(store.originalHeaders),
+		cookieHeader: store.cookieHeader,
+		parsedCookies: store.parsedCookies ? new Map(store.parsedCookies) : void 0,
+		searchParams: new URLSearchParams(store.searchParams),
+		searchString: store.searchString,
+		segmentParams: store.segmentParams ? { ...store.segmentParams } : void 0,
+		cookieJar: /* @__PURE__ */ new Map(),
+		flushed: false,
+		mutableContext: false
+	};
+}
+/**
+* Kick off a background re-render via waitUntil. The re-render runs inside
+* a fresh ALS scope with snapshotted request context.
+*/
+function backgroundRerender(id, component, props, cacheKey, options, hasSeed, snapshot) {
+	const waitUntil = getWaitUntil();
+	const tags = resolveTags(options, props);
+	const oKey = overlayKey(id, cacheKey);
+	const startEpoch = currentInvalidationEpoch();
+	const sfKey = `prebuilt-bg:${id}:${cacheKey}\0${lastInvalidationEpochFor(oKey, tags)}`;
+	const work = requestContextAls.run(snapshot, () => componentSingleflight.do(sfKey, async (signal) => {
+		const bytes = await captureComponentPayload(id, component, props);
+		if (!signal.aborted && !wasInvalidatedSince(startEpoch, oKey, tags)) await storeOverlayEntry(id, cacheKey, bytes, {
+			ttl: options.ttl,
+			tags,
+			hasSeed
+		});
+	}).catch((error) => {
+		console.error(`[timber] cache.component background re-render failed for "${id}":`, error);
+	}));
+	if (waitUntil) waitUntil(work);
+	else if (!warnedNoWaitUntil) {
+		warnedNoWaitUntil = true;
+		console.warn("[timber] cache.component SWR background re-render has no waitUntil — the re-render may be killed when the handler returns on serverless platforms. Ensure the adapter wires runWithWaitUntil().");
+	}
+}
+/**
+* Try to serve this render from the prebuilt cache: overlay → artifact →
+* live render. Handles ISR (SWR, tombstones, re-renders) per design/45.
+*
+* Null on any miss — the caller renders live.
+*/
+async function tryRevivePayload(id, options, props) {
+	const hasSource = hasPrebuiltPayloadSource();
+	const hasRuntime = hasRuntimeLifetime(options);
+	if (!hasSource && !hasRuntime) return null;
+	const store = requestContextAls.getStore();
+	if (!store) return null;
+	const keyParams = (options.prerender ? await isParamIndependent(id) : false) ? {} : resolveKeyParams(store);
+	if (keyParams === null) return null;
+	const allProps = props ?? {};
+	let keyProps;
+	const childrenValue = allProps.children;
+	if (childrenValue != null && typeof childrenValue === "object" && "type" in childrenValue && childrenValue.type === ChildSegmentOutlet) {
+		const { children: _children, ...rest } = allProps;
+		keyProps = rest;
+	} else keyProps = allProps;
+	const cacheKey = computeComponentCacheKey(keyProps, keyParams);
+	if (cacheKey === null) return null;
+	const outcome = options.fallbackOnMissingSegmentParams === false ? "failing the render (fallbackOnMissingSegmentParams: false)" : "rendering dynamically";
+	const component = registry.get(id)?.component;
+	if (hasRuntime) {
+		const overlayResult = await lookupOverlay(id, cacheKey);
+		if (overlayResult) {
+			const overlayHasSeed = overlayResult.record?.s ?? false;
+			if (overlayResult.kind === "tombstone") {
+				if (component) return await inlineRerender(id, component, props, cacheKey, options, true, outcome);
+				return null;
+			}
+			if (overlayResult.kind === "fresh" && overlayResult.payload) return await revivePayload(id, overlayResult.payload, outcome);
+			if (overlayResult.kind === "stale" && overlayResult.payload) {
+				if (options.staleWhileRevalidate && component) {
+					backgroundRerender(id, component, props, cacheKey, options, overlayHasSeed, snapshotRequestContext(store));
+					return await revivePayload(id, overlayResult.payload, outcome);
+				}
+				if (component) return await inlineRerender(id, component, props, cacheKey, options, overlayHasSeed, outcome);
+				return null;
+			}
+		}
+	}
+	if (hasSource) {
+		const artifactPayload = await lookupPrebuiltPayload(id, cacheKey);
+		if (artifactPayload !== null) {
+			if (options.ttl !== void 0) {
+				const buildTs = (await getManifestEntry(id, cacheKey))?.buildTimestamp ?? 0;
+				if ((Date.now() - buildTs) / 1e3 > options.ttl) {
+					if (options.staleWhileRevalidate && component) {
+						backgroundRerender(id, component, props, cacheKey, options, true, snapshotRequestContext(store));
+						return await revivePayload(id, artifactPayload, outcome);
+					}
+					if (component) return await inlineRerender(id, component, props, cacheKey, options, true, outcome);
+					return null;
+				}
+			}
+			return await revivePayload(id, artifactPayload, outcome);
+		}
+		if (options.prerender) console.warn(`[timber] cache.component cache miss: "${id}" with params ${JSON.stringify(store.segmentParams ?? {})} — ${outcome}`);
+	}
+	if (hasRuntime && component && options.fallbackOnMissingSegmentParams !== false) return await inlineRerender(id, component, props, cacheKey, options, false, outcome);
+	return null;
+}
+/**
+* Production wrapper injected by the timber-prebuilt transform. Registers
+* the component under its stable ID and returns a wrapper component that
+* either revives the cached payload (hit) or renders the original
+* component live (miss).
+*/
+function __prebuilt(id, component, options = {}) {
+	registry.set(id, {
+		id,
+		component,
+		options
+	});
+	const wrapper = async (props) => {
+		noteWrapperRender(id, options);
+		if (isCaptureActive()) return createElement(component, props);
+		const revived = await tryRevivePayload(id, options, props);
+		if (revived !== null) return revived.element;
+		if (options.fallbackOnMissingSegmentParams === false) throw new Error(`[timber] cache.component "${id}": no prebuilt payload for the current params and fallbackOnMissingSegmentParams is false`);
+		return createElement(component, props);
+	};
+	Object.defineProperty(wrapper, "name", { value: `Prebuilt(${id})` });
+	return wrapper;
+}
+/** Look up a registration by stable component ID. */
+function getPrebuiltRegistration(id) {
+	return registry.get(id);
+}
+/** All registrations, for the post-build capture pass (TIM-1119). */
+function getPrebuiltRegistry() {
+	return registry;
+}
+/**
+* Dev-mode wrapper injected by the timber-prebuilt transform: a no-op that
+* renders the component dynamically on every request, logging once per
+* component on first render so the production behavior difference is visible.
+* See design/44 §Dev Mode.
+*/
+function __prebuiltDev(name, component, _options) {
+	let logged = false;
+	const wrapper = (props) => {
+		if (!logged) {
+			logged = true;
+			console.log(`[timber] cache.component: "${name}" — rendering dynamically (dev mode)`);
+		}
+		return createElement(component, props);
+	};
+	return wrapper;
+}
+//#endregion
+export { AccessGate, DEFAULT_LIMITS, DenySignal, METADATA_ROUTE_CONVENTIONS, RedirectSignal, RenderError, RenderTimeoutError, SlotAccessGate, __prebuilt, __prebuiltDev, buildElementTree, callOnRequestError, canonicalize, classifyMetadataRoute, coerce, collectEarlyHintHeaders, computeComponentCacheKey, createPipeline, enforceBodyLimits, executeAction, formatLinkHeader, generateTraceId, getCookie, getHeader, getLogger, getMetadataRouteAutoLink, getMetadataRouteServePath, getPrebuiltRegistration, getPrebuiltRegistry, getSearchParams, getSegmentParams, getSetCookieHeaders, handleRouteRequest, hasOnRequestError, hasPrebuiltPayloadSource, loadInstrumentation, logCacheMiss, logMiddlewareError, logMiddlewareShortCircuit, logProxyError, logRenderError, logRequestCompleted, logRequestReceived, logSlowRequest, logSwrRefetchFailed, logWaitUntilRejected, logWaitUntilUnsupported, markResponseFlushed, parseBodySize, renderMetadataToElements, replaceTraceId, resolveAllowedMethods, resolveMetadata, resolveMetadataUrls, resolveSlotDenied, resolveStatusFile, resolveTitle, runMiddleware, runProxy, runWithEarlyHintsSender, runWithRequestContext, runWithTraceId, sendEarlyHints103, setLogger, setMutableCookieContext, setPrebuiltPayloadSource, setSegmentParams, validateCsrf };
+
+//# sourceMappingURL=internal.js.map