@farm.js/core 0.1.47 → 0.1.48

package/dist/chunk-NIPKC4DA.mjs

@@ -0,0 +1,800 @@
+import {
+  DEFAULT_ERROR_STYLES
+} from "./chunk-XAXTTBUT.mjs";
+import {
+  serializeFarmLlmsTxt
+} from "./chunk-LAZK6UV7.mjs";
+import {
+  stampFarmCspNonce
+} from "./chunk-22W4FNTG.mjs";
+import {
+  resolveFarmThemeConfig
+} from "./chunk-YWPNIYUP.mjs";
+import {
+  emitFarmAgentRead
+} from "./chunk-N77JBPLC.mjs";
+import {
+  integrationMiddlewareMayHandlePath
+} from "./chunk-F6TLUMH7.mjs";
+import {
+  compileMiddlewareConfig,
+  matchesCompiledMiddlewareConfig,
+  matchesMiddlewareRoute
+} from "./chunk-EDPENAVO.mjs";
+import {
+  omitFarmResponseBody
+} from "./chunk-D7Y63SOY.mjs";
+import {
+  createFarmAPIMiddlewarePathnames
+} from "./chunk-LM2YOGDK.mjs";
+import {
+  matchSegmentParts,
+  normalizePathname,
+  parseRoutePattern,
+  splitNormalizedPathname
+} from "./chunk-MFQGU5CC.mjs";
+import {
+  localizeFarmPathname
+} from "./chunk-7S7AAK2D.mjs";
+
+// src/routing/route-groups.ts
+function isRouteGroupSegment(part) {
+  return part.startsWith("(") && part.endsWith(")");
+}
+function formatRouteSegment(segment) {
+  if (!segment.isDynamic) return segment.segment;
+  if (segment.isCatchAll) {
+    return segment.isOptional ? `[[...${segment.segment}]]` : `[...${segment.segment}]`;
+  }
+  return `[${segment.segment}]`;
+}
+function createRouteDirectoryPattern(route) {
+  const parts = route.filePath.replace(/\\/g, "/").split("/").filter(Boolean);
+  parts.pop();
+  if (parts.length === 0) return "/";
+  let segmentIndex = 0;
+  const directory = parts.map((part) => {
+    if (isRouteGroupSegment(part)) return part;
+    const segment = route.segments[segmentIndex++];
+    return segment ? formatRouteSegment(segment) : part;
+  });
+  return `/${directory.join("/")}`;
+}
+function stripRouteGroups(pattern) {
+  if (!pattern.includes("(")) return pattern;
+  const parts = pattern.split("/").filter((part) => part && !isRouteGroupSegment(part));
+  return parts.length === 0 ? "/" : `/${parts.join("/")}`;
+}
+function getRouteGroupScope(pattern) {
+  if (!pattern.includes("(")) return null;
+  const parts = pattern.split("/");
+  for (let index = parts.length - 1; index > 0; index--) {
+    if (isRouteGroupSegment(parts[index])) return parts.slice(0, index + 1).join("/");
+  }
+  return null;
+}
+function isInRouteGroupScope(directory, scope) {
+  if (scope === null) return true;
+  if (typeof directory !== "string") return false;
+  return directory === scope || directory.startsWith(`${scope}/`);
+}
+function getRouteDirectoryDepth(pattern) {
+  return pattern.split("/").filter(Boolean).length;
+}
+function routeBoundaryCoversDirectory(boundaryPattern, directory) {
+  const boundaryUrl = stripRouteGroups(boundaryPattern);
+  const routeUrl = stripRouteGroups(directory);
+  return (boundaryUrl === "/" || routeUrl === boundaryUrl || routeUrl.startsWith(`${boundaryUrl.replace(/\/$/, "")}/`)) && isInRouteGroupScope(directory, getRouteGroupScope(boundaryPattern));
+}
+
+// src/routing/layout-selector.ts
+function createFarmLayoutSelector(layouts, resolveRouteDirectory) {
+  const prepared = layouts.map((layout) => {
+    const segments = layout.pattern === "/" ? [] : parseRoutePattern(layout.pattern);
+    return {
+      layout,
+      segments: segments.length === 0 ? null : segments,
+      groupScope: getRouteGroupScope(layout.pattern)
+    };
+  });
+  return (pathname, routeDirectory) => {
+    const applicable = [];
+    let parts;
+    let directory = routeDirectory;
+    for (const { layout, segments, groupScope } of prepared) {
+      if (segments !== null) {
+        parts ?? (parts = splitNormalizedPathname(normalizePathname(pathname.replace(/\/$/, "") || "/")));
+        if (matchSegmentParts(segments, parts, true) === null) continue;
+      }
+      if (groupScope !== null) {
+        if (directory === void 0) directory = resolveRouteDirectory?.(pathname) ?? null;
+        if (!isInRouteGroupScope(directory, groupScope)) continue;
+      }
+      applicable.push(layout);
+    }
+    return applicable;
+  };
+}
+function layoutsCanCoverSamePage(a, b) {
+  const scopeA = getRouteGroupScope(a);
+  const scopeB = getRouteGroupScope(b);
+  if (scopeA !== null && scopeB !== null && !isInRouteGroupScope(scopeA, scopeB) && !isInRouteGroupScope(scopeB, scopeA)) {
+    return false;
+  }
+  const segmentsA = a === "/" ? [] : parseRoutePattern(a);
+  const segmentsB = b === "/" ? [] : parseRoutePattern(b);
+  const length = Math.min(segmentsA.length, segmentsB.length);
+  for (let index = 0; index < length; index++) {
+    const segmentA = segmentsA[index];
+    const segmentB = segmentsB[index];
+    if (segmentA.type === "dynamic" && segmentA.catchAll) return true;
+    if (segmentB.type === "dynamic" && segmentB.catchAll) return true;
+    if (segmentA.type === "dynamic" || segmentB.type === "dynamic") continue;
+    if (segmentA.value !== segmentB.value) return false;
+  }
+  return true;
+}
+function getFarmServerTreeLayoutPatterns(layouts) {
+  const hydrating = layouts.filter((layout) => layout.shouldHydrate).map((layout) => layout.pattern);
+  const patterns = /* @__PURE__ */ new Set();
+  for (const layout of layouts) {
+    if (layout.serverTreeLayout || !layout.shouldHydrate && hydrating.some((pattern) => layoutsCanCoverSamePage(layout.pattern, pattern))) {
+      patterns.add(layout.pattern);
+    }
+  }
+  return patterns;
+}
+
+// src/navigation/render-plan.ts
+function createFarmRouteRenderPlan(input = {}) {
+  const pageShouldHydrate = input.pageShouldHydrate === true;
+  const layoutShouldHydrate = input.layoutShouldHydrate === true;
+  const hydration = pageShouldHydrate ? layoutShouldHydrate ? "route-and-layout-islands" : "route-island" : layoutShouldHydrate ? "layout-island" : "none";
+  const rendering = input.rendering;
+  const cache = rendering?.ssg ? typeof rendering.revalidate === "number" && rendering.revalidate > 0 ? { mode: "revalidate", revalidate: rendering.revalidate } : { mode: "static" } : { mode: "dynamic" };
+  return {
+    version: 1,
+    output: "html",
+    navigation: "html-fragment",
+    hydration,
+    islandStrategy: hydration === "none" ? null : input.islandStrategy ?? "load",
+    cache
+  };
+}
+function getFarmFragmentCacheControl(plan) {
+  if (plan.cache.mode === "static") {
+    return "public, max-age=0, s-maxage=31536000, immutable";
+  }
+  if (plan.cache.mode === "revalidate") {
+    const seconds = Math.max(1, plan.cache.revalidate ?? 1);
+    return `public, max-age=0, s-maxage=${seconds}, stale-while-revalidate=${seconds}`;
+  }
+  return "private, max-age=0";
+}
+function parseFarmLayoutChainHeader(value) {
+  if (!value || value.length > 8192) return [];
+  try {
+    const parsed = JSON.parse(value);
+    if (!Array.isArray(parsed) || parsed.length > 64) return [];
+    return parsed.filter(
+      (pattern) => typeof pattern === "string" && pattern.startsWith("/") && pattern.length <= 512
+    );
+  } catch {
+    return [];
+  }
+}
+function getSharedLayoutPrefixLength(current, next) {
+  let index = 0;
+  while (index < current.length && index < next.length && current[index] === next[index]) {
+    index++;
+  }
+  return index;
+}
+
+// src/server/full-document.ts
+var CONTENTS_WRAPPER = /^<div\b[^>]*style="display\s*:\s*contents;?\s*"[^>]*>/i;
+var HOISTED_HEAD_ELEMENT = /^(?:<(?:meta|link|base)\b[^>]*>|<title\b[^>]*>[\s\S]*?<\/title>|<script\b[^>]*\basync\b[^>]*><\/script>|<style\b[^>]*\bdata-precedence\b[^>]*>[\s\S]*?<\/style>)/i;
+function peelDocumentPrefix(markup) {
+  let inner = markup.replace(/^\s+/, "");
+  let hoisted = "";
+  let match;
+  while (match = CONTENTS_WRAPPER.exec(inner) ?? HOISTED_HEAD_ELEMENT.exec(inner)) {
+    if (!/^<div/i.test(match[0])) hoisted += match[0];
+    inner = inner.slice(match[0].length).replace(/^\s+/, "");
+  }
+  return { inner, hoisted };
+}
+function restoreHoistedHead(document, hoisted) {
+  if (!hoisted) return document;
+  if (/<head[\s>]/i.test(document)) {
+    return document.replace(/<head\b[^>]*>/i, (open) => open + hoisted);
+  }
+  return document.replace(/<html\b[^>]*>/i, (open) => `${open}<head>${hoisted}</head>`);
+}
+function extractFarmFullDocument(markup) {
+  const { inner, hoisted } = peelDocumentPrefix(markup);
+  if (!/^<!doctype/i.test(inner) && !/^<html[\s>]/i.test(inner)) return null;
+  const start = markup.search(/<!doctype|<html[\s>]/i);
+  const lower = markup.toLowerCase();
+  let closeIndex = lower.lastIndexOf("</html>");
+  if (lower.length !== markup.length) {
+    closeIndex = -1;
+    const closing = /<\/html>/gi;
+    let match;
+    while (match = closing.exec(markup)) closeIndex = match.index;
+  }
+  if (start < 0 || closeIndex < 0) return null;
+  const closeEnd = closeIndex + "</html>".length;
+  let document = markup.slice(start, closeEnd);
+  const streamedTail = markup.slice(closeEnd).replace(/^(?:\s*<\/div>)+/i, "").trim();
+  if (streamedTail) {
+    document = document.replace(/<\/body>/i, () => `${streamedTail}</body>`);
+  }
+  return restoreHoistedHead(document, hoisted);
+}
+function classifyFarmDocumentPrefix(markup) {
+  const { inner } = peelDocumentPrefix(markup);
+  if (/^<!doctype/i.test(inner) || /^<html[\s>]/i.test(inner)) return "document";
+  return inner === "" ? "pending" : "fragment";
+}
+function ensureFarmDocumentHead(markup) {
+  if (/<head[\s>]/i.test(markup)) return markup;
+  return markup.replace(/<html([^>]*)>/i, (_match, attributes) => {
+    return `<html${attributes}><head></head>`;
+  });
+}
+function ensureFarmDocumentRoot(markup) {
+  if (/<body\b[^>]*>\s*<div\b[^>]*\sid=["']root["']/i.test(markup)) return markup;
+  return markup.replace(
+    /<body\b([^>]*)>/i,
+    (_match, attributes) => `<body${attributes}><div id="root">`
+  ).replace(/<\/body>/i, () => "</div></body>");
+}
+function hasFarmDocumentIcon(markup) {
+  return /<link\b[^>]*\brel=["']?(?:shortcut )?icon\b/i.test(markup);
+}
+function removeFarmDocumentTitles(markup) {
+  return markup.replace(/<title\b[^>]*>[\s\S]*?<\/title>\s*/gi, "");
+}
+function ensureFarmDocumentMeta(markup, viewport = "") {
+  const head = /<head\b[^>]*>([\s\S]*?)<\/head>/i.exec(markup)?.[1] ?? "";
+  const hasNamedMeta = (name) => new RegExp(`<meta\\b[^>]*\\bname=["']?${name}(?=["'\\s/>])`, "i").test(head);
+  const tags = [
+    /<meta\b[^>]*\bcharset\s*=/i.test(head) ? "" : '<meta charset="utf-8">',
+    ...(viewport.match(/<meta\b[^>]*>/gi) ?? []).filter((tag) => {
+      const name = /\bname="([\w-]+)"/.exec(tag)?.[1];
+      return !name || !hasNamedMeta(name);
+    })
+  ].filter(Boolean);
+  if (tags.length === 0) return markup;
+  return markup.replace(/<head\b[^>]*>/i, (open) => `${open}${tags.join("")}`);
+}
+function composeFarmFullDocument(documentHtml, assets) {
+  let html = ensureFarmDocumentMeta(ensureFarmDocumentHead(documentHtml), assets.viewport);
+  if (assets.htmlAttributes) {
+    html = html.replace(/<html\b([^>]*)>/i, (_match, attrs) => {
+      let nextAttributes = attrs;
+      for (const name of assets.replaceHtmlAttributes ?? []) {
+        const escapedName = name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        nextAttributes = nextAttributes.replace(
+          new RegExp("\\s+" + escapedName + `=(?:"[^"]*"|'[^']*'|[^\\s>]+)`, "gi"),
+          ""
+        );
+      }
+      return `<html${nextAttributes}${assets.htmlAttributes}>`;
+    });
+  }
+  html = ensureFarmDocumentRoot(html);
+  const headAssets = [
+    assets.fallbackIcon && !hasFarmDocumentIcon(html) ? '<link rel="icon" href="data:,">' : "",
+    assets.headAssets
+  ].filter(Boolean).join("\n  ");
+  if (headAssets) {
+    html = html.replace(/<\/head>/i, () => `  ${headAssets}
+</head>`);
+  }
+  if (assets.bodyFooter) {
+    html = html.replace(/<\/body>/i, () => `  ${assets.bodyFooter}
+</body>`);
+  }
+  return /^\s*<!doctype/i.test(html) ? html : `<!DOCTYPE html>
+${html}`;
+}
+
+// src/middleware/may-handle.ts
+function hasFarmMiddlewareConfig(config) {
+  if (!config) return false;
+  if (Array.isArray(config)) return config.length > 0;
+  const configRecord = config;
+  return Boolean(
+    configRecord.matcher || configRecord.exclude || configRecord.runtime || configRecord.handler || Array.isArray(configRecord.handlers) && configRecord.handlers.length > 0
+  );
+}
+function configMiddlewareMayHandlePath(config, pathname) {
+  if (!hasFarmMiddlewareConfig(config)) return false;
+  const entries = Array.isArray(config) ? config : [config];
+  return entries.some((entry) => {
+    if (!entry.matcher && !entry.exclude) return true;
+    const matchers = entry.matcher ? (Array.isArray(entry.matcher) ? entry.matcher : [entry.matcher]).map(
+      (matcher) => (
+        // A request-aware matcher cannot be proven safe at build time.
+        typeof matcher === "function" ? () => true : matcher
+      )
+    ) : void 0;
+    const compiled = compileMiddlewareConfig({ matcher: matchers, exclude: entry.exclude });
+    return matchesCompiledMiddlewareConfig(pathname, compiled, {}).matched;
+  });
+}
+function appMiddlewareMayHandlePath(middlewareRoutes, pathname) {
+  return middlewareRoutes.some((route) => matchesMiddlewareRoute(pathname, route).matched);
+}
+var CATCH_ALL_PROBE = "/__farm-listing-probe__/0";
+function isPathSpecificMatcher(matcher) {
+  if (typeof matcher === "function") return false;
+  const compiled = compileMiddlewareConfig({ matcher });
+  return !matchesCompiledMiddlewareConfig(CATCH_ALL_PROBE, compiled, {}).matched;
+}
+function pathSpecificConfigMiddlewareCovers(config, pathname) {
+  if (!hasFarmMiddlewareConfig(config)) return false;
+  const entries = Array.isArray(config) ? config : [config];
+  return entries.some((entry) => {
+    if (!entry.matcher) return false;
+    const matchers = (Array.isArray(entry.matcher) ? entry.matcher : [entry.matcher]).filter(
+      isPathSpecificMatcher
+    );
+    if (matchers.length === 0) return false;
+    const compiled = compileMiddlewareConfig({ matcher: matchers, exclude: entry.exclude });
+    return matchesCompiledMiddlewareConfig(pathname, compiled, {}).matched;
+  });
+}
+function farmPathGuardCoversPage(options, pathname) {
+  return appMiddlewareMayHandlePath(
+    options.middlewareRoutes.filter((route) => route.path !== "/"),
+    pathname
+  ) || pathSpecificConfigMiddlewareCovers(options.config.middleware, pathname) || integrationMiddlewareMayHandlePath(options.config.integrations, pathname, CATCH_ALL_PROBE);
+}
+function farmPathGuardCoversEndpoint(options, path, apiServerBasePath) {
+  return createFarmAPIMiddlewarePathnames(apiServerBasePath)(path).some(
+    (pathname) => farmPathGuardCoversPage(options, pathname)
+  );
+}
+
+// src/i18n/alternates.ts
+function renderFarmLocaleAlternateLinks(pathname, config, options = {}) {
+  if (config.routing === "none") return "";
+  const base = resolveAlternateBase(options);
+  const link = (hreflang, locale) => `<link rel="alternate" hreflang="${escapeHtmlAttribute(hreflang)}" href="${escapeHtmlAttribute(
+    resolveAlternateHref(localizeFarmPathname(pathname, locale, config), base)
+  )}">`;
+  const links = config.locales.map((locale) => link(locale, locale));
+  links.push(link("x-default", config.defaultLocale));
+  return links.join("");
+}
+function resolveAlternateBase(options) {
+  for (const candidate of [options.metadataBase, options.origin]) {
+    if (typeof candidate !== "string" && !(candidate instanceof URL)) continue;
+    try {
+      const url = new URL(candidate);
+      if (url.protocol === "http:" || url.protocol === "https:") return url;
+    } catch {
+    }
+  }
+  return void 0;
+}
+function resolveAlternateHref(pathname, base) {
+  if (!base) return pathname;
+  return new URL(pathname.replace(/^[/\\]+/, "/"), base).href;
+}
+function escapeHtmlAttribute(value) {
+  return value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+
+// src/navigation/late-navigation-recovery.ts
+var PAGE_CONTAINER_ID = "__farm_page__";
+var TEMPLATE_ID = "__farm_late_not_found__";
+function serializeForInlineScript(value) {
+  return JSON.stringify(value).replace(/</g, "\\u003c").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
+}
+function isLateRedirectTarget(url) {
+  try {
+    const protocol = new URL(url, "https://farm.invalid").protocol;
+    return protocol === "http:" || protocol === "https:";
+  } catch {
+    return false;
+  }
+}
+function createLateRedirectRecovery(url, nonce) {
+  if (!isLateRedirectTarget(url)) return "";
+  return stampFarmCspNonce(
+    `<script>window.location.replace(${serializeForInlineScript(url)})</script>`,
+    nonce
+  );
+}
+function createLateNotFoundRecovery(content, nonce) {
+  return `<template id="${TEMPLATE_ID}">${content}</template>` + stampFarmCspNonce(
+    `<script>(function(){var t=document.getElementById("${TEMPLATE_ID}");var p=document.getElementById("${PAGE_CONTAINER_ID}");if(t&&p){p.replaceChildren(t.content.cloneNode(true));}if(t)t.remove();document.documentElement.dataset.farmLateNotFound="true";var m=document.createElement("meta");m.name="robots";m.content="noindex";document.head.appendChild(m);})();</script>`,
+    nonce
+  );
+}
+
+// src/metadata-route.ts
+function isResponse(value) {
+  return typeof Response !== "undefined" && (value instanceof Response || Boolean(
+    value && typeof value === "object" && typeof value.arrayBuffer === "function" && value.headers
+  ));
+}
+function isRecord(value) {
+  return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+function resolveCacheControl(revalidate) {
+  if (revalidate === false) {
+    return "public, max-age=31536000, immutable";
+  }
+  if (typeof revalidate === "number" && Number.isFinite(revalidate) && revalidate > 0) {
+    return `public, s-maxage=${Math.floor(revalidate)}, stale-while-revalidate=300`;
+  }
+  return "public, max-age=0, must-revalidate";
+}
+function escapeXml(value) {
+  return String(value).replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+function serializeSitemap(value) {
+  if (!Array.isArray(value)) {
+    throw new TypeError("sitemap.ts must return an array or a Response");
+  }
+  const entries = value.map((candidate, index) => {
+    if (!isRecord(candidate) || typeof candidate.url !== "string" || !candidate.url) {
+      throw new TypeError(`sitemap.ts entry ${index} must include a non-empty url`);
+    }
+    return candidate;
+  });
+  const hasLanguageAlternates = entries.some(
+    (entry) => entry.alternates?.languages && Object.keys(entry.alternates.languages).length > 0
+  );
+  const namespace = hasLanguageAlternates ? ' xmlns:xhtml="http://www.w3.org/1999/xhtml"' : "";
+  const lines = [
+    '<?xml version="1.0" encoding="UTF-8"?>',
+    `<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"${namespace}>`
+  ];
+  for (const entry of entries) {
+    lines.push("  <url>", `    <loc>${escapeXml(entry.url)}</loc>`);
+    if (entry.lastModified !== void 0) {
+      const lastModified = entry.lastModified instanceof Date ? entry.lastModified.toISOString() : entry.lastModified;
+      lines.push(`    <lastmod>${escapeXml(lastModified)}</lastmod>`);
+    }
+    if (entry.changeFrequency) {
+      lines.push(`    <changefreq>${escapeXml(entry.changeFrequency)}</changefreq>`);
+    }
+    if (entry.priority !== void 0) {
+      lines.push(`    <priority>${escapeXml(entry.priority)}</priority>`);
+    }
+    for (const [language, href] of Object.entries(entry.alternates?.languages || {})) {
+      lines.push(
+        `    <xhtml:link rel="alternate" hreflang="${escapeXml(language)}" href="${escapeXml(href)}" />`
+      );
+    }
+    lines.push("  </url>");
+  }
+  lines.push("</urlset>");
+  return `${lines.join("\n")}
+`;
+}
+function toArray(value) {
+  return value === void 0 ? [] : Array.isArray(value) ? value : [value];
+}
+function serializeRobots(value) {
+  if (!isRecord(value)) {
+    throw new TypeError("robots.ts must return a robots object or a Response");
+  }
+  const robots = value;
+  const rules = toArray(robots.rules);
+  if (rules.length === 0) {
+    throw new TypeError("robots.ts must return at least one rule");
+  }
+  const sections = rules.map((rule, index) => {
+    if (!isRecord(rule)) {
+      throw new TypeError(`robots.ts rule ${index} must be an object`);
+    }
+    const userAgents = toArray(rule.userAgent).filter(
+      (userAgent) => typeof userAgent === "string" && Boolean(userAgent)
+    );
+    if (userAgents.length === 0) {
+      throw new TypeError(`robots.ts rule ${index} must include a userAgent`);
+    }
+    const lines = userAgents.map((userAgent) => `User-agent: ${userAgent}`);
+    for (const allow of toArray(rule.allow)) lines.push(`Allow: ${allow}`);
+    for (const disallow of toArray(rule.disallow)) lines.push(`Disallow: ${disallow}`);
+    if (rule.crawlDelay !== void 0) lines.push(`Crawl-delay: ${rule.crawlDelay}`);
+    return lines.join("\n");
+  });
+  const globalLines = [
+    ...toArray(robots.sitemap).map((sitemap) => `Sitemap: ${sitemap}`),
+    ...robots.host ? [`Host: ${robots.host}`] : []
+  ];
+  return `${[...sections, ...globalLines.length ? [globalLines.join("\n")] : []].join("\n\n")}
+`;
+}
+function serializeManifest(value) {
+  if (!isRecord(value)) {
+    throw new TypeError("manifest.ts must return a manifest object or a Response");
+  }
+  return `${JSON.stringify(value, null, 2)}
+`;
+}
+function createFarmMetadataRouteResponse(kind, value, routeModule = {}, options = {}) {
+  const method = (options.method || "GET").toUpperCase();
+  if (method !== "GET" && method !== "HEAD") {
+    return new Response(null, { status: 405, headers: { Allow: "GET, HEAD" } });
+  }
+  if ((kind === "llms" || kind === "llms-full") && options.request) {
+    emitFarmAgentRead(options.request, kind, isResponse(value) ? value.status : 200);
+  }
+  if (isResponse(value)) {
+    return method === "HEAD" ? omitFarmResponseBody(value) : value;
+  }
+  const body = kind === "sitemap" ? serializeSitemap(value) : kind === "robots" ? serializeRobots(value) : kind === "llms" || kind === "llms-full" ? serializeFarmLlmsTxt(value) : serializeManifest(value);
+  const contentType = kind === "sitemap" ? "application/xml; charset=utf-8" : kind === "robots" || kind === "llms" || kind === "llms-full" ? "text/plain; charset=utf-8" : "application/manifest+json; charset=utf-8";
+  return new Response(method === "HEAD" ? null : body, {
+    headers: {
+      "Content-Type": contentType,
+      "Cache-Control": resolveCacheControl(routeModule.revalidate),
+      "X-Content-Type-Options": "nosniff"
+    }
+  });
+}
+
+// src/components/error-page.ts
+var ERROR_STATUS_TEXT = {
+  400: "Bad Request",
+  401: "Unauthorized",
+  402: "Payment Required",
+  403: "Forbidden",
+  404: "Not Found",
+  405: "Method Not Allowed",
+  406: "Not Acceptable",
+  408: "Request Timeout",
+  409: "Conflict",
+  410: "Gone",
+  411: "Length Required",
+  412: "Precondition Failed",
+  413: "Content Too Large",
+  414: "URI Too Long",
+  415: "Unsupported Media Type",
+  416: "Range Not Satisfiable",
+  418: "I'm a Teapot",
+  422: "Unprocessable Content",
+  423: "Locked",
+  424: "Failed Dependency",
+  425: "Too Early",
+  426: "Upgrade Required",
+  428: "Precondition Required",
+  429: "Too Many Requests",
+  431: "Request Header Fields Too Large",
+  451: "Unavailable For Legal Reasons",
+  500: "Internal Server Error",
+  501: "Not Implemented",
+  502: "Bad Gateway",
+  503: "Service Unavailable",
+  504: "Gateway Timeout",
+  505: "HTTP Version Not Supported",
+  506: "Variant Also Negotiates",
+  507: "Insufficient Storage",
+  508: "Loop Detected",
+  510: "Not Extended",
+  511: "Network Authentication Required"
+};
+var ERROR_TITLES = {
+  400: "This request could not be completed",
+  401: "Authentication is required",
+  403: "You do not have access to this page",
+  404: "This page could not be found",
+  405: "This request method is not supported",
+  408: "The request took too long",
+  409: "The request conflicts with the current state",
+  410: "This resource is no longer available",
+  413: "The request is too large",
+  422: "The request could not be processed",
+  429: "Too many requests were sent",
+  500: "Something went wrong",
+  501: "This operation is not implemented",
+  502: "An upstream service returned an invalid response",
+  503: "The service is temporarily unavailable",
+  504: "An upstream service took too long to respond"
+};
+var ERROR_PUBLIC_MESSAGES = {
+  400: "Check the request details, then try again.",
+  401: "Sign in and try this request again.",
+  403: "Use an account with the required permissions or return home.",
+  404: "Check the address or return to the home page.",
+  405: "Use a supported request method and try again.",
+  408: "Try the request again in a moment.",
+  409: "Refresh the page, review the latest state, and try again.",
+  410: "Return home to continue browsing.",
+  413: "Reduce the request size and try again.",
+  422: "Review the request data and try again.",
+  429: "Wait a moment before trying again.",
+  500: "The application ran into an unexpected problem. Try again in a moment.",
+  501: "This operation is not available yet.",
+  502: "Try again after the upstream service recovers.",
+  503: "Try again in a moment.",
+  504: "Try again after the upstream service recovers."
+};
+function escapeHtml(value) {
+  return String(value ?? "").replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+function serializeJsonForHtml(value) {
+  return JSON.stringify(value).replace(/</g, "\\u003c").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
+}
+function normalizeErrorStatus(status) {
+  const value = typeof status === "string" && status.trim() ? Number(status) : status;
+  return typeof value === "number" && Number.isInteger(value) && value >= 400 && value <= 599 ? value : void 0;
+}
+function resolveDefaultErrorStatus(error) {
+  if (error && typeof error === "object") {
+    const candidate = error;
+    return normalizeErrorStatus(candidate.status) ?? normalizeErrorStatus(candidate.statusCode) ?? 500;
+  }
+  return 500;
+}
+function getDefaultErrorStatusText(statusCode) {
+  return ERROR_STATUS_TEXT[statusCode] || (statusCode >= 500 ? "Server Error" : "Request Error");
+}
+function getDefaultErrorTitle(statusCode) {
+  return ERROR_TITLES[statusCode] || (statusCode >= 500 ? "The server could not complete the request" : "The request could not be completed");
+}
+function getDefaultErrorPublicMessage(statusCode) {
+  return ERROR_PUBLIC_MESSAGES[statusCode] || "Try again or return to the home page.";
+}
+function createSourceFrameMarkup(sourceFrame) {
+  if (!sourceFrame) {
+    return `<p class="farm-default-error__details-empty">Source location is unavailable. Copy the debug report to inspect the filtered stack trace.</p>`;
+  }
+  const lines = sourceFrame.lines.map(
+    (line) => `<span class="farm-default-error__source-line${line.highlight ? " farm-default-error__source-line--active" : ""}"><span class="farm-default-error__source-gutter">${line.highlight ? "&gt;" : "&nbsp;"} ${line.number}</span><span class="farm-default-error__source-text">${escapeHtml(line.content || " ")}</span></span>`
+  ).join("\n");
+  return `<div class="farm-default-error__source"><p class="farm-default-error__source-path">${escapeHtml(sourceFrame.file)}:${sourceFrame.line}:${sourceFrame.column}</p><pre class="farm-default-error__source-code" tabindex="0"><code>${lines}</code></pre></div>`;
+}
+function createDebugReport(options) {
+  const statusText = options.statusText || getDefaultErrorStatusText(options.statusCode);
+  const sourceFrame = options.sourceFrame;
+  const source = sourceFrame ? [
+    `\`${sourceFrame.file}:${sourceFrame.line}:${sourceFrame.column}\``,
+    "",
+    "```text",
+    ...sourceFrame.lines.map(
+      (line) => `${line.highlight ? ">" : " "} ${String(line.number).padStart(4, " ")} | ${line.content}`
+    ),
+    "```"
+  ].join("\n") : "Source frame unavailable.";
+  return [
+    "# Farm.js debug report",
+    "",
+    "## Error",
+    `- Status: ${options.statusCode} ${statusText}`,
+    `- Name: ${options.errorName || "Error"}`,
+    `- Message: ${options.message || getDefaultErrorPublicMessage(options.statusCode)}`,
+    `- Request: ${(options.method || "GET").toUpperCase()} ${options.requestPath || "/"}`,
+    "",
+    "## Runtime",
+    `- Farm.js: ${options.farmVersion || "unknown"}`,
+    `- Node.js: ${options.nodeVersion || "unknown"}`,
+    `- Mode: ${options.mode || "development"}`,
+    "",
+    "## Source",
+    source,
+    "",
+    "## Filtered stack",
+    "```text",
+    options.stack || "Stack trace unavailable.",
+    "```"
+  ].join("\n");
+}
+var ERROR_PAGE_SCRIPT = `<script>(function(){var root=document.querySelector("[data-farm-default-error]");if(!root)return;var retry=root.querySelector("[data-farm-error-retry]");var back=root.querySelector("[data-farm-error-back]");if(retry)retry.addEventListener("click",function(){window.location.reload()});if(back)back.addEventListener("click",function(){if(window.history.length>1){window.history.back()}else{window.location.assign("/")}})})();</script>`;
+var ERROR_COPY_SCRIPT = `<script>(function(){var root=document.querySelector("[data-farm-default-error]");var copy=root&&root.querySelector("[data-farm-error-copy]");var report=document.getElementById("farm-default-error-report");if(!copy||!report)return;copy.addEventListener("click",async function(){var value="";try{value=JSON.parse(report.textContent||'""')}catch(_error){value=report.textContent||""}try{if(navigator.clipboard&&window.isSecureContext){await navigator.clipboard.writeText(value)}else{var area=document.createElement("textarea");area.value=value;area.setAttribute("readonly","");area.style.position="fixed";area.style.opacity="0";document.body.appendChild(area);area.select();document.execCommand("copy");area.remove()}var label=copy.querySelector("[data-farm-error-copy-label]");var status=copy.querySelector("[data-farm-error-copy-status]");if(label)label.textContent="COPIED";if(status)status.textContent="Debug report copied";window.setTimeout(function(){if(label)label.textContent="COPY DEBUG REPORT";if(status)status.textContent=""},1800)}catch(_error){var status=copy.querySelector("[data-farm-error-copy-status]");if(status)status.textContent="Unable to copy the debug report"}})})();</script>`;
+var ERROR_DOCS_ICON = `<svg class="farm-default-error__docs-icon" viewBox="0 0 16 16" fill="none" aria-hidden="true" focusable="false"><path d="M2.75 2.75h3.5A1.75 1.75 0 0 1 8 4.5v8.75a1.75 1.75 0 0 0-1.75-1.75h-3.5v-8.75Z"/><path d="M13.25 2.75h-3.5A1.75 1.75 0 0 0 8 4.5v8.75a1.75 1.75 0 0 1 1.75-1.75h3.5v-8.75Z"/></svg>`;
+function createDefaultErrorMarkup(options = {}) {
+  const statusCode = normalizeErrorStatus(options.statusCode) ?? 500;
+  const statusText = options.statusText || getDefaultErrorStatusText(statusCode);
+  const development = options.development === true;
+  const title = getDefaultErrorTitle(statusCode);
+  const message = development && options.message ? options.message : getDefaultErrorPublicMessage(statusCode);
+  const requestPath = options.requestPath || "/";
+  const method = (options.method || "GET").toUpperCase();
+  const isServerError = statusCode >= 500;
+  const details = development ? `<section class="farm-default-error__details" aria-labelledby="farm-default-error-details-title"><div class="farm-default-error__details-header"><h2 id="farm-default-error-details-title" class="farm-default-error__details-title">Technical details</h2></div>${createSourceFrameMarkup(options.sourceFrame)}<p class="farm-default-error__meta">Farm.js v${escapeHtml(options.farmVersion || "unknown")} \xB7 ${escapeHtml(options.mode || "development")} \xB7 Node.js ${escapeHtml(options.nodeVersion || "unknown")}</p></section>` : "";
+  const report = development ? `<script id="farm-default-error-report" type="application/json">${serializeJsonForHtml(createDebugReport({ ...options, statusCode, statusText, requestPath, method }))}</script>${ERROR_COPY_SCRIPT}` : "";
+  const primaryAction = isServerError ? `<button class="farm-default-error__action farm-default-error__action--primary" type="button" data-farm-error-retry>TRY AGAIN</button>` : `<button class="farm-default-error__action farm-default-error__action--primary" type="button" data-farm-error-back>GO BACK</button>`;
+  const debugAction = development ? `<span class="farm-default-error__footer-divider" aria-hidden="true">/</span><button class="farm-default-error__footer-action" type="button" data-farm-error-copy><span data-farm-error-copy-label>COPY DEBUG REPORT</span><span class="farm-default-error__sr-only" aria-live="polite" data-farm-error-copy-status></span></button>` : "";
+  return `<style>${DEFAULT_ERROR_STYLES}</style><main class="farm-default-error${development ? " farm-default-error--development" : ""}" data-farm-default-error role="alert" aria-labelledby="farm-default-error-title" aria-describedby="farm-default-error-description"><div class="farm-default-error__frame"><div class="farm-default-error__brand" aria-hidden="true"><span>FARM.JS</span><span class="farm-default-error__brand-divider">/</span><span>ERROR</span></div><div class="farm-default-error__content"><p class="farm-default-error__status"><span class="farm-default-error__status-mark" aria-hidden="true"></span><span>${statusCode}</span><span class="farm-default-error__status-divider" aria-hidden="true">/</span><span>${escapeHtml(statusText)}</span></p><header class="farm-default-error__summary"><h1 id="farm-default-error-title" class="farm-default-error__title">${escapeHtml(title)}</h1><p id="farm-default-error-description" class="farm-default-error__message">${escapeHtml(message)}</p></header><div class="farm-default-error__actions">${primaryAction}<a class="farm-default-error__action" href="/">RETURN HOME</a></div><section class="farm-default-error__panel" aria-label="Error information"><div class="farm-default-error__row"><span class="farm-default-error__label">Request</span><span class="farm-default-error__value">${escapeHtml(method)} ${escapeHtml(requestPath)}</span></div><div class="farm-default-error__row"><span class="farm-default-error__label">Status</span><span class="farm-default-error__value">${statusCode} ${escapeHtml(statusText)}</span></div>${details}</section></div><footer class="farm-default-error__footer"><a class="farm-default-error__footer-action" href="https://farmjs.dev/docs" target="_blank" rel="noopener noreferrer">${ERROR_DOCS_ICON}<span>VIEW DOCUMENTATION</span></a>${debugAction}</footer></div>${report}${ERROR_PAGE_SCRIPT}</main>`;
+}
+
+// src/theme/server-runtime.ts
+var THEME_SCRIPT_ID = "farm-theme-script";
+var THEME_STYLE_ID = "farm-theme-style";
+function createFarmThemeDocumentParts(input, basePath = "/", serverTheme) {
+  const config = resolveFarmThemeConfig(input, basePath);
+  if (!config.enabled) return { attributes: "", head: "" };
+  const hydrationTheme = serverTheme ?? config.default;
+  const initialTheme = hydrationTheme === "system" ? "light" : hydrationTheme;
+  const script = createFarmThemeBootstrapScript(config, hydrationTheme);
+  return {
+    attributes: ` data-theme="${initialTheme}"`,
+    head: stampFarmCspNonce(
+      `<style id="${THEME_STYLE_ID}">:root[data-theme="light"]{color-scheme:light}:root[data-theme="dark"]{color-scheme:dark}</style><script id="${THEME_SCRIPT_ID}">${script}</script>`
+    )
+  };
+}
+function createFarmThemeBootstrapScript(config, serverTheme = config.default) {
+  return `(function(config,serverTheme){
+var isTheme=function(value){return value==="light"||value==="dark"||value==="system";};
+var decode=function(value){try{return decodeURIComponent(value);}catch(_error){return value;}};
+var readCookie=function(){var entries=document.cookie.split(";");for(var index=0;index<entries.length;index++){var entry=entries[index];var separator=entry.indexOf("=");if(separator<0)continue;if(decode(entry.slice(0,separator).trim())===config.storageKey)return decode(entry.slice(separator+1).trim());}};
+var media=window.matchMedia("(prefers-color-scheme: dark)");
+var resolveTheme=function(theme){return theme==="system"?(media.matches?"dark":"light"):theme;};
+var storedTheme=readCookie();
+var preference=isTheme(storedTheme)?storedTheme:config.default;
+var serverSnapshot={theme:serverTheme,resolvedTheme:serverTheme==="system"?undefined:serverTheme,mounted:false};
+var apply=function(){var resolvedTheme=resolveTheme(preference);document.documentElement.dataset.theme=resolvedTheme;var snapshot={theme:preference,resolvedTheme:resolvedTheme,mounted:true};if(window.__FARM_THEME__)window.__FARM_THEME__.snapshot=snapshot;return snapshot;};
+var emit=function(){var snapshot=apply();window.dispatchEvent(new CustomEvent("farm:themechange",{detail:snapshot}));};
+var persist=function(theme){var secure=window.location.protocol==="https:"?"; Secure":"";document.cookie=encodeURIComponent(config.storageKey)+"="+encodeURIComponent(theme)+"; Path="+config.cookiePath+"; Max-Age=31536000; SameSite=Lax"+secure;try{localStorage.setItem(config.storageKey,theme);}catch(_error){}};
+var setTheme=function(theme){if(!isTheme(theme))throw new TypeError("Unknown FARMJS theme: "+String(theme));preference=theme;persist(theme);emit();};
+var initialSnapshot={theme:preference,resolvedTheme:resolveTheme(preference),mounted:true};
+window.__FARM_THEME__={config:config,serverSnapshot:serverSnapshot,snapshot:initialSnapshot,setTheme:setTheme};
+document.documentElement.dataset.theme=initialSnapshot.resolvedTheme;
+var handleSystemChange=function(){if(preference==="system")emit();};
+if(typeof media.addEventListener==="function")media.addEventListener("change",handleSystemChange);else if(typeof media.addListener==="function")media.addListener(handleSystemChange);
+window.addEventListener("storage",function(event){if(event.key!==config.storageKey||!isTheme(event.newValue))return;preference=event.newValue;persist(preference);emit();});
+})(${serializeInlineValue(config)},${serializeInlineValue(serverTheme)});`;
+}
+function applyFarmThemeDocument(html, input, basePath = "/", serverTheme) {
+  const parts = createFarmThemeDocumentParts(input, basePath, serverTheme);
+  if (!parts.head) return html;
+  let output = html.replace(/<html([^>]*)>/i, (_match, attributes) => {
+    const nextAttributes = attributes.replace(/\sdata-theme=(?:"[^"]*"|'[^']*'|[^\s>]+)/i, "");
+    return `<html${nextAttributes}${parts.attributes}>`;
+  });
+  if (!output.includes(`id="${THEME_SCRIPT_ID}"`)) {
+    output = output.replace(/<head([^>]*)>/i, `<head$1>${parts.head}`);
+  }
+  return output;
+}
+function serializeInlineValue(value) {
+  return JSON.stringify(value).replace(/</g, "\\u003c").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
+}
+
+export {
+  formatRouteSegment,
+  createRouteDirectoryPattern,
+  stripRouteGroups,
+  getRouteGroupScope,
+  isInRouteGroupScope,
+  getRouteDirectoryDepth,
+  routeBoundaryCoversDirectory,
+  createFarmLayoutSelector,
+  layoutsCanCoverSamePage,
+  getFarmServerTreeLayoutPatterns,
+  createFarmRouteRenderPlan,
+  getFarmFragmentCacheControl,
+  parseFarmLayoutChainHeader,
+  getSharedLayoutPrefixLength,
+  HOISTED_HEAD_ELEMENT,
+  extractFarmFullDocument,
+  classifyFarmDocumentPrefix,
+  removeFarmDocumentTitles,
+  ensureFarmDocumentMeta,
+  composeFarmFullDocument,
+  hasFarmMiddlewareConfig,
+  configMiddlewareMayHandlePath,
+  appMiddlewareMayHandlePath,
+  farmPathGuardCoversPage,
+  farmPathGuardCoversEndpoint,
+  renderFarmLocaleAlternateLinks,
+  createLateRedirectRecovery,
+  createLateNotFoundRecovery,
+  createFarmMetadataRouteResponse,
+  resolveDefaultErrorStatus,
+  getDefaultErrorStatusText,
+  createDefaultErrorMarkup,
+  createFarmThemeDocumentParts,
+  applyFarmThemeDocument
+};