@farm.js/core 0.1.47 → 0.1.48

package/dist/chunk-GXSMF7UR.mjs

@@ -0,0 +1,1923 @@
+import {
+  generateFarmDocsSearchBootstrapRuntime,
+  isFarmDocsSearchEnabled
+} from "./chunk-WB6XES4V.mjs";
+import {
+  FARM_NAVIGATION_HEAD_SELECTOR
+} from "./chunk-WYL4ODZ4.mjs";
+import {
+  docsEngine,
+  loadFarmDocsEngine
+} from "./chunk-VE3FWJBO.mjs";
+import {
+  resolveFarmDocsFontAssets,
+  toFarmDocsPublicFontAssets
+} from "./chunk-NRNAHZ57.mjs";
+import {
+  stampFarmCspNonce
+} from "./chunk-22W4FNTG.mjs";
+import {
+  farmAcceptQuality
+} from "./chunk-N77JBPLC.mjs";
+import {
+  matchesFarmIfNoneMatch
+} from "./chunk-C6U66WWF.mjs";
+
+// src/docs/handler.ts
+import {
+  existsSync as existsSync2,
+  readdirSync as readdirSync2,
+  readFileSync as readFileSync2,
+  realpathSync as realpathSync2,
+  statSync as statSync2
+} from "fs";
+import path2 from "path";
+import { marked, Renderer } from "marked";
+import { highlight } from "sugar-high";
+
+// src/docs/last-modified.ts
+import { execFileSync } from "child_process";
+import { existsSync, readFileSync, readdirSync, realpathSync, statSync } from "fs";
+import path from "path";
+var FARM_DOCS_LAST_MODIFIED_MANIFEST = ".farm-docs-last-modified.json";
+var COMMIT_MARKER = "__FARM_DOCS_COMMIT__";
+var DOCS_FILE_EXTENSIONS = /* @__PURE__ */ new Set([".md", ".mdx"]);
+var manifestCache = /* @__PURE__ */ new Map();
+function normalizeRelativePath(value) {
+  return value.replace(/\\/g, "/").replace(/^\.\/+/, "");
+}
+function resolveExistingPath(filePath) {
+  try {
+    return realpathSync(filePath);
+  } catch {
+    return path.resolve(filePath);
+  }
+}
+function isDocsSourceFile(filePath) {
+  return DOCS_FILE_EXTENSIONS.has(path.extname(filePath).toLowerCase());
+}
+function discoverDocsSourceFiles(contentDir) {
+  const files = [];
+  const visit = (dir) => {
+    for (const entry of readdirSync(dir, { withFileTypes: true }).sort(
+      (a, b) => a.name.localeCompare(b.name)
+    )) {
+      if (entry.name.startsWith(".") || entry.name === "node_modules") continue;
+      const absolutePath = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        visit(absolutePath);
+      } else if (entry.isFile() && isDocsSourceFile(absolutePath)) {
+        files.push(absolutePath);
+      }
+    }
+  };
+  if (existsSync(contentDir)) visit(contentDir);
+  return files;
+}
+function getGitLastModifiedDates(contentDir) {
+  try {
+    const gitRoot = execFileSync("git", ["-C", contentDir, "rev-parse", "--show-toplevel"], {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim();
+    if (!gitRoot) return {};
+    const contentPathspec = normalizeRelativePath(path.relative(gitRoot, contentDir)) || ".";
+    const contentPrefix = contentPathspec === "." ? "" : `${contentPathspec}/`;
+    const history = execFileSync(
+      "git",
+      [
+        "-C",
+        gitRoot,
+        "-c",
+        "core.quotePath=false",
+        "log",
+        `--format=${COMMIT_MARKER}%cI`,
+        "--name-only",
+        "--",
+        contentPathspec
+      ],
+      {
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "ignore"],
+        maxBuffer: 32 * 1024 * 1024
+      }
+    );
+    const pages = {};
+    let commitDate;
+    for (const rawLine of history.split(/\r?\n/)) {
+      const line = normalizeRelativePath(rawLine.trim());
+      if (!line) continue;
+      if (line.startsWith(COMMIT_MARKER)) {
+        commitDate = line.slice(COMMIT_MARKER.length);
+        continue;
+      }
+      if (!commitDate || contentPrefix && !line.startsWith(contentPrefix)) continue;
+      const relativePath = contentPrefix ? line.slice(contentPrefix.length) : line;
+      if (isDocsSourceFile(relativePath) && !pages[relativePath]) {
+        pages[relativePath] = commitDate;
+      }
+    }
+    return pages;
+  } catch {
+    return {};
+  }
+}
+function readManifest(contentDir) {
+  const manifestPath = path.join(contentDir, FARM_DOCS_LAST_MODIFIED_MANIFEST);
+  if (!existsSync(manifestPath)) return null;
+  try {
+    const parsed = JSON.parse(
+      readFileSync(manifestPath, "utf8")
+    );
+    if (parsed.version !== 1 || !parsed.pages || typeof parsed.pages !== "object") return null;
+    const pages = Object.fromEntries(
+      Object.entries(parsed.pages).filter(
+        (entry) => typeof entry[1] === "string" && entry[1].length > 0
+      )
+    );
+    return { version: 1, pages };
+  } catch {
+    return null;
+  }
+}
+function createFarmDocsLastModifiedManifest(contentDir, options = {}) {
+  const resolvedContentDir = resolveExistingPath(contentDir);
+  const gitDates = getGitLastModifiedDates(resolvedContentDir);
+  const fallbackDate = (options.now ?? /* @__PURE__ */ new Date()).toISOString();
+  const pages = {};
+  for (const sourcePath of discoverDocsSourceFiles(resolvedContentDir)) {
+    const relativePath = normalizeRelativePath(path.relative(resolvedContentDir, sourcePath));
+    pages[relativePath] = gitDates[relativePath] || (options.fallback === "now" ? fallbackDate : statSync(sourcePath).mtime.toISOString());
+  }
+  return { version: 1, pages };
+}
+function getLastModifiedManifest(contentDir) {
+  const resolvedContentDir = resolveExistingPath(contentDir);
+  const manifestPath = path.join(resolvedContentDir, FARM_DOCS_LAST_MODIFIED_MANIFEST);
+  const manifestStat = existsSync(manifestPath) ? statSync(manifestPath) : null;
+  const signature = manifestStat ? `file:${manifestStat.mtimeMs}:${manifestStat.size}` : "generated";
+  const cached = manifestCache.get(resolvedContentDir);
+  if (cached?.signature === signature) return cached.manifest;
+  const manifest = readManifest(resolvedContentDir) ?? createFarmDocsLastModifiedManifest(resolvedContentDir);
+  manifestCache.set(resolvedContentDir, { signature, manifest });
+  return manifest;
+}
+function resolveFarmDocsPageLastModified(contentDir, sourcePath, frontmatter) {
+  const configured = frontmatter.lastModified || frontmatter.lastmod || frontmatter.lastUpdated || frontmatter.updatedAt;
+  if (configured) return configured;
+  const resolvedContentDir = resolveExistingPath(contentDir);
+  const resolvedSourcePath = resolveExistingPath(sourcePath);
+  const relativePath = normalizeRelativePath(path.relative(resolvedContentDir, resolvedSourcePath));
+  const isInsideContentDir = relativePath !== ".." && !relativePath.startsWith("../") && !path.isAbsolute(relativePath);
+  if (isInsideContentDir) {
+    const generated = getLastModifiedManifest(resolvedContentDir).pages[relativePath];
+    if (generated) return generated;
+  }
+  return statSync(resolvedSourcePath).mtime.toISOString();
+}
+
+// src/docs/social-image.ts
+import { createHash } from "crypto";
+var FARM_DOCS_SOCIAL_IMAGE_WIDTH = 1200;
+var FARM_DOCS_SOCIAL_IMAGE_HEIGHT = 630;
+var FARM_DOCS_SOCIAL_IMAGE_VERSION = 3;
+function normalizeEntry(entry) {
+  if (!entry || entry === "/") return "";
+  return `/${entry.replace(/^\/+|\/+$/g, "")}`;
+}
+function encodeSlugPath(slug) {
+  return slug.split("/").filter(Boolean).map((segment) => encodeURIComponent(segment)).join("/");
+}
+function getSocialImageConfig(docs) {
+  return typeof docs.config.socialImage === "object" && docs.config.socialImage ? docs.config.socialImage : void 0;
+}
+function getNavTitle(docs) {
+  if (typeof docs.config.nav !== "object" || !docs.config.nav || !("title" in docs.config.nav)) {
+    return "Farm.js";
+  }
+  return String(docs.config.nav.title || "Farm.js");
+}
+function isFalse(value) {
+  return value ? /^(false|no|none|off|disabled)$/i.test(value.trim()) : false;
+}
+function isExternalOrRootPath(value) {
+  return /^(https?:)?\/\//i.test(value) || value.startsWith("/");
+}
+function isFarmDocsSocialImageEnabled(page, docs) {
+  if (docs.config.socialImage === false || getSocialImageConfig(docs)?.enabled === false) {
+    return false;
+  }
+  return !isFalse(page.frontmatter.socialImage);
+}
+function getFarmDocsCustomSocialImage(page) {
+  const value = page.frontmatter.socialImage || page.frontmatter.openGraphImage || page.frontmatter.ogImage;
+  return value && !isFalse(value) && isExternalOrRootPath(value) ? value : void 0;
+}
+function resolveIllustration(page) {
+  const explicit = page.frontmatter.socialIllustration?.toLowerCase();
+  if (explicit === "auth" || explicit === "cache" || explicit === "cli" || explicit === "integrations" || explicit === "project" || explicit === "routing" || explicit === "runtime") {
+    return explicit;
+  }
+  const source = `${page.slug} ${page.title} ${page.section || ""}`.toLowerCase();
+  if (/auth|session|security|csrf/.test(source)) return "auth";
+  if (/cache|ppr|render|static|revalid|stream/.test(source)) return "cache";
+  if (/integration|stripe|prisma|better.auth|email|job|workflow/.test(source)) {
+    return "integrations";
+  }
+  if (/cli|test|deploy|preview|upgrade|migration|install/.test(source)) return "cli";
+  if (/project|structure|config|environment|markdown|docs.engine/.test(source)) {
+    return "project";
+  }
+  if (/rout|endpoint|middleware|navigation|server.function|server.action|api/.test(source)) {
+    return "routing";
+  }
+  return "runtime";
+}
+function createHashValue(value) {
+  return createHash("sha256").update(JSON.stringify(value)).digest("hex").slice(0, 16);
+}
+function resolveBaseUrl(requestUrl, config) {
+  return config?.baseUrl ? new URL(config.baseUrl) : new URL(requestUrl.origin);
+}
+function createFarmDocsSocialImageDescriptor(page, docs, requestUrl) {
+  const config = getSocialImageConfig(docs);
+  const siteName = config?.siteName || getNavTitle(docs);
+  const brand = config?.brand || siteName;
+  const title = page.frontmatter.socialTitle || page.title;
+  const description = page.frontmatter.socialDescription || page.description || docs.config.metadata?.description || `Documentation for ${siteName}`;
+  const section = page.frontmatter.section || page.section || "Documentation";
+  const illustration = resolveIllustration(page);
+  const entry = normalizeEntry(docs.entry);
+  const slugPath = encodeSlugPath(page.slug) || "index";
+  const imagePath = `${entry}/_social/${slugPath}/opengraph-image.svg`;
+  const baseUrl = resolveBaseUrl(requestUrl, config);
+  const pageUrl = new URL(page.href, baseUrl).href;
+  const imageAlt = `${title} \u2014 ${siteName} documentation`;
+  const hash = createHashValue({
+    version: FARM_DOCS_SOCIAL_IMAGE_VERSION,
+    title,
+    description,
+    section,
+    siteName,
+    brand,
+    pageHref: page.href,
+    illustration,
+    fonts: config?.fonts
+  });
+  return {
+    title,
+    description,
+    section,
+    siteName,
+    brand,
+    pageHref: page.href,
+    pageUrl,
+    imagePath,
+    imageUrl: new URL(`${imagePath}?v=${hash}`, baseUrl).href,
+    imageAlt,
+    illustration,
+    fonts: config?.fonts,
+    hash
+  };
+}
+function getFarmDocsSocialImageSlug(docs, requestUrl) {
+  const entry = normalizeEntry(docs.entry);
+  const prefix = `${entry}/_social/`;
+  const suffix = "/opengraph-image.svg";
+  if (!requestUrl.pathname.startsWith(prefix) || !requestUrl.pathname.endsWith(suffix)) {
+    return null;
+  }
+  const rawSlug = requestUrl.pathname.slice(prefix.length, -suffix.length);
+  if (!rawSlug) return null;
+  try {
+    const slug = rawSlug.split("/").map((segment) => decodeURIComponent(segment)).join("/");
+    if (slug.split("/").some((segment) => !segment || segment === ".." || segment === ".")) {
+      return null;
+    }
+    return slug === "index" ? "" : slug;
+  } catch {
+    return null;
+  }
+}
+function escapeXml(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+function truncate(value, length) {
+  if (value.length <= length) return value;
+  return `${value.slice(0, Math.max(0, length - 1)).trimEnd()}\u2026`;
+}
+function wrapText(value, maxCharacters, maxLines) {
+  const words = value.trim().split(/\s+/).filter(Boolean);
+  const lines = [];
+  let current = "";
+  let consumedWords = 0;
+  for (const word of words) {
+    const candidate = current ? `${current} ${word}` : word;
+    if (candidate.length <= maxCharacters || !current) {
+      current = candidate;
+      consumedWords += 1;
+      continue;
+    }
+    lines.push(current);
+    if (lines.length === maxLines) break;
+    current = word;
+    consumedWords += 1;
+  }
+  if (current && lines.length < maxLines) lines.push(current);
+  if (consumedWords < words.length && lines.length) {
+    lines[lines.length - 1] = truncate(`${lines[lines.length - 1]}\u2026`, maxCharacters);
+  }
+  return lines;
+}
+function renderTextLines(lines, x, y, lineHeight, attributes) {
+  return lines.map(
+    (line, index) => `<text x="${x}" y="${y + index * lineHeight}" ${attributes}>${escapeXml(line)}</text>`
+  ).join("");
+}
+function renderEmbeddedFont(name, source, weight) {
+  if (!source) return "";
+  return `@font-face{font-family:"${name}";src:url("${escapeXml(source)}") format("woff2");font-style:normal;font-weight:${weight};font-display:block;}`;
+}
+function renderArrow(x1, y, x2, color = "#8b8b8b") {
+  return `<path d="M${x1} ${y}H${x2 - 9}" fill="none" stroke="${color}"/><path d="m${x2 - 9} ${y - 5} 9 5-9 5" fill="none" stroke="${color}"/>`;
+}
+function renderPanelHeader(label, status) {
+  return `<text x="819" y="171" class="label">${escapeXml(label)}</text><text x="1134" y="171" class="label bright" text-anchor="end">${escapeXml(status)}</text>`;
+}
+function renderRoutingIllustration() {
+  return `${renderPanelHeader("ROUTE BLUEPRINT", "TYPED")}
+    <rect x="819" y="296" width="92" height="54" fill="#a3a3a3"/>
+    <text x="832" y="327" class="diagram-title ink">src/app</text>
+    <path d="M911 323h41M952 232v181M952 232h44M952 323h44M952 413h44" fill="none" stroke="#696969"/>
+    <rect x="996" y="205" width="138" height="54" fill="#0a0a0a" stroke="#414141"/>
+    <text x="1010" y="228" class="diagram-title">/</text><text x="1010" y="246" class="micro">STATIC</text>
+    <rect x="996" y="296" width="138" height="54" fill="#0a0a0a" stroke="#414141"/>
+    <text x="1010" y="319" class="diagram-title">/blog/:slug</text><text x="1010" y="337" class="micro">DYNAMIC</text>
+    <rect x="996" y="386" width="138" height="55" fill="#f0f0f0"/>
+    <text x="1010" y="410" class="diagram-title ink">/docs/:path*</text><text x="1010" y="428" class="micro ink-muted">CATCH-ALL</text>
+    <line x1="819" y1="450" x2="1134" y2="450" stroke="#343434"/>
+    <text x="819" y="475" class="label bright">FILE ROUTES</text><text x="1134" y="475" class="label" text-anchor="end">TYPES INCLUDED</text>`;
+}
+function renderAuthIllustration() {
+  return `${renderPanelHeader("REQUEST GUARD", "SERVER VERIFIED")}
+    <rect x="819" y="269" width="86" height="54" fill="#0a0a0a" stroke="#454545"/>
+    <text x="837" y="292" class="micro bright">REQUEST</text><text x="837" y="310" class="diagram-title">GET /app</text>
+    ${renderArrow(905, 296, 943)}
+    <rect x="943" y="224" width="104" height="118" fill="#f0f0f0"/>
+    <path d="M974 271v-12a21 21 0 0 1 42 0v12M968 271h54v45h-54z" fill="#050505"/>
+    <circle cx="995" cy="292" r="4" fill="#f0f0f0"/><path d="M995 296v8" stroke="#f0f0f0" stroke-width="3"/>
+    <text x="995" y="332" class="micro ink" text-anchor="middle">auth()</text>
+    ${renderArrow(1047, 296, 1071)}
+    <rect x="1071" y="269" width="63" height="54" fill="#0a0a0a" stroke="#454545"/>
+    <text x="1082" y="292" class="micro bright">ALLOW</text><text x="1082" y="310" class="micro">/app</text>
+    <rect x="819" y="372" width="315" height="38" fill="#090909" stroke="#3d3d3d"/>
+    <rect x="832" y="385" width="11" height="11" fill="#a3a3a3"/>
+    <text x="856" y="395" class="code">session.user / verified</text>
+    <line x1="819" y1="450" x2="1134" y2="450" stroke="#343434"/>
+    <text x="819" y="475" class="label bright">SESSION TYPED</text><text x="1134" y="475" class="label" text-anchor="end">CSRF PROTECTED</text>`;
+}
+function renderCacheIllustration() {
+  return `${renderPanelHeader("PAGE / PRODUCT", "CACHE + PPR")}
+    <rect x="819" y="204" width="315" height="54" fill="#f0f0f0"/>
+    <text x="836" y="235" class="diagram-title ink">STATIC SHELL</text><text x="1116" y="235" class="micro ink-muted" text-anchor="end">BUILD</text>
+    <rect x="819" y="271" width="198" height="76" fill="#a3a3a3"/>
+    <text x="836" y="301" class="diagram-title ink">CACHED DATA</text><text x="836" y="326" class="micro ink-muted">tag: products</text>
+    <rect x="1029" y="271" width="105" height="76" fill="#0a0a0a" stroke="#555"/>
+    <text x="1045" y="301" class="diagram-title">LIVE</text><text x="1045" y="326" class="micro">stream</text>
+    <path d="M1081 347v43m-8-9 8 9 8-9" fill="none" stroke="#d4d4d4"/>
+    <line x1="819" y1="450" x2="1134" y2="450" stroke="#343434"/>
+    <text x="819" y="475" class="label bright">STATIC FIRST</text><text x="1134" y="475" class="label" text-anchor="end">DYNAMIC WHERE NEEDED</text>`;
+}
+function renderIntegrationsIllustration() {
+  return `${renderPanelHeader("INTEGRATION GRAPH", "ONE PRODUCT")}
+    <path d="M976 309H879V247M976 309H879v87M1030 309h93V247M1030 309h93v87" fill="none" stroke="#4a4a4a"/>
+    <rect x="819" y="214" width="120" height="57" fill="#0a0a0a" stroke="#4b4b4b"/><text x="839" y="247" class="diagram-title">BETTER AUTH</text>
+    <rect x="819" y="368" width="120" height="57" fill="#0a0a0a" stroke="#4b4b4b"/><text x="851" y="401" class="diagram-title">PRISMA</text>
+    <rect x="1061" y="214" width="73" height="57" fill="#0a0a0a" stroke="#4b4b4b"/><text x="1077" y="247" class="diagram-title">STRIPE</text>
+    <rect x="1061" y="368" width="73" height="57" fill="#a3a3a3"/><text x="1075" y="401" class="diagram-title ink">VERCEL</text>
+    <rect x="976" y="277" width="94" height="64" fill="#f0f0f0"/>
+    <text x="994" y="304" class="diagram-title ink">FARM.JS</text><text x="994" y="324" class="micro ink-muted">CORE</text>
+    <line x1="819" y1="450" x2="1134" y2="450" stroke="#343434"/>
+    <text x="819" y="475" class="label bright">BRING YOUR STACK</text><text x="1134" y="475" class="label" text-anchor="end">CONNECTED ONCE</text>`;
+}
+function renderCliIllustration() {
+  return `${renderPanelHeader("TERMINAL", "PRODUCTION OUTPUT")}
+    <rect x="819" y="203" width="315" height="213" fill="#050505" stroke="#555"/>
+    <line x1="819" y1="236" x2="1134" y2="236" stroke="#555"/>
+    <circle cx="837" cy="220" r="4" fill="#5d5d5d"/><circle cx="850" cy="220" r="4" fill="#7a7a7a"/><circle cx="863" cy="220" r="4" fill="#a3a3a3"/>
+    <text x="837" y="273" class="code bright"><tspan fill="#7a7a7a">$</tspan> farm build</text>
+    <rect x="837" y="293" width="11" height="11" fill="#a3a3a3"/><path d="m839 298 3 3 6-7" fill="none" stroke="#050505" stroke-width="1.5"/>
+    <text x="861" y="303" class="code">64 routes discovered</text>
+    <rect x="837" y="320" width="11" height="11" fill="#a3a3a3"/><path d="m839 325 3 3 6-7" fill="none" stroke="#050505" stroke-width="1.5"/>
+    <text x="861" y="330" class="code">client + server bundles</text>
+    <rect x="837" y="355" width="126" height="30" fill="#f0f0f0"/><text x="853" y="374" class="micro ink">BUILD COMPLETE</text>
+    <text x="1115" y="374" class="micro" text-anchor="end">/dist</text>
+    <line x1="819" y1="450" x2="1134" y2="450" stroke="#343434"/>
+    <text x="819" y="475" class="label bright">REAL COMMANDS</text><text x="1134" y="475" class="label" text-anchor="end">842MS</text>`;
+}
+function renderProjectIllustration() {
+  return `${renderPanelHeader("PROJECT MAP", "CONVENTION TYPED")}
+    <rect x="819" y="202" width="315" height="216" fill="#050505" stroke="#555"/>
+    <text x="837" y="227" class="diagram-title bright">my-app/</text>
+    <path d="M847 243v143M847 259h23M847 293h23M847 327h23M847 361h23" fill="none" stroke="#666"/>
+    <rect x="870" y="243" width="246" height="33" fill="#0a0a0a" stroke="#444"/><text x="886" y="264" class="code">src/app</text><text x="1098" y="264" class="micro" text-anchor="end">ROUTES</text>
+    <rect x="870" y="277" width="246" height="33" fill="#f0f0f0"/><text x="886" y="298" class="code ink">src/app/page.tsx</text>
+    <rect x="870" y="311" width="246" height="33" fill="#0a0a0a" stroke="#444"/><text x="886" y="332" class="code">src/app/api/users/route.ts</text><text x="1098" y="332" class="micro" text-anchor="end">API</text>
+    <rect x="870" y="345" width="246" height="33" fill="#0a0a0a" stroke="#444"/><text x="886" y="366" class="code">farm.config.ts</text><text x="1098" y="366" class="micro" text-anchor="end">CONFIG</text>
+    <line x1="819" y1="450" x2="1134" y2="450" stroke="#343434"/>
+    <text x="819" y="475" class="label bright">FILES BECOME FEATURES</text><text x="1134" y="475" class="label" text-anchor="end">ONE CONFIG</text>`;
+}
+function renderRuntimeIllustration() {
+  return `${renderPanelHeader("PRODUCT ARCHITECTURE", "FULL STACK")}
+    <rect x="819" y="211" width="315" height="55" fill="#f0f0f0"/>
+    <text x="836" y="244" class="diagram-title ink">PRODUCT SURFACE</text><text x="1116" y="244" class="micro ink-muted" text-anchor="end">UI + ROUTES</text>
+    <path d="M976 266v20m0 61v20" stroke="#727272"/>
+    <rect x="855" y="286" width="242" height="61" fill="#a3a3a3"/>
+    <text x="874" y="314" class="diagram-title ink">APPLICATION CORE</text><text x="874" y="334" class="micro ink-muted">APIS \xB7 MIDDLEWARE</text>
+    <rect x="819" y="367" width="315" height="55" fill="#4c4c4c"/>
+    <text x="836" y="400" class="diagram-title bright">CONNECTED STACK</text><text x="1116" y="400" class="micro" text-anchor="end">DATA \xB7 AUTH \xB7 DEPLOY</text>
+    <line x1="819" y1="450" x2="1134" y2="450" stroke="#343434"/>
+    <text x="819" y="475" class="label bright">ONE FRAMEWORK</text><text x="1134" y="475" class="label" text-anchor="end">ONE DEPLOYMENT MODEL</text>`;
+}
+function renderIllustration(type) {
+  switch (type) {
+    case "auth":
+      return renderAuthIllustration();
+    case "cache":
+      return renderCacheIllustration();
+    case "cli":
+      return renderCliIllustration();
+    case "integrations":
+      return renderIntegrationsIllustration();
+    case "project":
+      return renderProjectIllustration();
+    case "routing":
+      return renderRoutingIllustration();
+    default:
+      return renderRuntimeIllustration();
+  }
+}
+function renderFarmDocsSocialImageSvg(descriptor) {
+  const titleLines = wrapText(descriptor.title, 22, 2);
+  const longestTitleLine = Math.max(...titleLines.map((line) => line.length));
+  const titleSize = titleLines.length === 1 ? longestTitleLine > 17 ? 62 : 74 : 56;
+  const titleLineHeight = Math.round(titleSize * 0.98);
+  const titleY = titleLines.length === 1 ? 294 : 266;
+  const descriptionY = titleY + (titleLines.length - 1) * titleLineHeight + 59;
+  const descriptionLines = wrapText(descriptor.description, 68, 2);
+  const routeY = Math.max(418, descriptionY + descriptionLines.length * 29 + 24);
+  const section = truncate(descriptor.section.toUpperCase(), 27);
+  const route = truncate(descriptor.pageHref, 42);
+  const footerUrl = truncate(descriptor.pageUrl.replace(/^https?:\/\//, ""), 70);
+  const brand = truncate(descriptor.brand.toUpperCase(), 25);
+  const titleId = `farm-docs-og-${descriptor.hash}`;
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="${FARM_DOCS_SOCIAL_IMAGE_WIDTH}" height="${FARM_DOCS_SOCIAL_IMAGE_HEIGHT}" viewBox="0 0 ${FARM_DOCS_SOCIAL_IMAGE_WIDTH} ${FARM_DOCS_SOCIAL_IMAGE_HEIGHT}" role="img" aria-labelledby="${titleId}-title ${titleId}-description">
+  <title id="${titleId}-title">${escapeXml(descriptor.imageAlt)}</title>
+  <desc id="${titleId}-description">${escapeXml(descriptor.description)}</desc>
+  <metadata>${escapeXml(JSON.stringify({ generator: "Farm.js docs", page: descriptor.pageUrl, illustration: descriptor.illustration }))}</metadata>
+  <style type="text/css">
+    ${renderEmbeddedFont("Farm Sans", descriptor.fonts?.sans, "100 900")}
+    ${renderEmbeddedFont("Farm Mono", descriptor.fonts?.mono, "100 900")}
+    ${renderEmbeddedFont("Farm Pixel", descriptor.fonts?.display, "400 700")}
+    .sans{font-family:"Farm Sans","Arial",sans-serif}.mono,.label,.code,.diagram-title,.micro{font-family:"Farm Mono","Menlo","DejaVu Sans Mono",monospace}.pixel{font-family:"Farm Pixel","Farm Mono",monospace}.label{fill:#8b8b8b;font-size:10px;font-weight:600;letter-spacing:1.2px}.code{fill:#8b8b8b;font-size:11px}.diagram-title{fill:#e7e7e7;font-size:11px;font-weight:650}.micro{fill:#777;font-size:8px;letter-spacing:.45px}.bright{fill:#f5f5f4}.ink{fill:#050505}.ink-muted{fill:#4c4c4c}
+  </style>
+  <defs>
+    <pattern id="canvas-grid" width="40" height="40" patternUnits="userSpaceOnUse"><path d="M40 0H0V40" fill="none" stroke="#151515"/></pattern>
+    <pattern id="diagonal" width="12" height="12" patternUnits="userSpaceOnUse" patternTransform="rotate(45)"><line x1="0" y1="0" x2="0" y2="12" stroke="#171717" stroke-width="2"/></pattern>
+    <clipPath id="frame-clip"><rect x="28" y="28" width="1144" height="574"/></clipPath>
+  </defs>
+  <rect width="1200" height="630" fill="#050505"/>
+  <rect width="1200" height="630" fill="url(#canvas-grid)"/>
+  <g clip-path="url(#frame-clip)">
+    <rect x="28" y="28" width="1144" height="574" fill="#020202"/>
+    <rect x="782" y="114" width="390" height="411" fill="url(#diagonal)"/>
+  </g>
+  <rect x="28.5" y="28.5" width="1143" height="573" fill="none" stroke="#323232"/>
+  <path d="M28 114.5h1144M28 525.5h1144M781.5 114v411" fill="none" stroke="#303030"/>
+
+  <g transform="translate(71 51)">
+    <rect width="11" height="11" rx="1" fill="#f5f5f4"/><rect x="15" width="28" height="11" rx="1" fill="#f5f5f4"/>
+    <rect y="15" width="11" height="11" rx="1" fill="#9b9b9b"/><rect x="15" y="15" width="28" height="11" rx="1" fill="#9b9b9b"/>
+    <rect y="30" width="11" height="11" rx="1" fill="#5f5f5f"/><rect x="15" y="30" width="20" height="11" rx="1" fill="#5f5f5f"/>
+    <text x="61" y="24" class="mono bright" font-size="24" font-weight="550">FARM<tspan fill="#777">.JS</tspan></text>
+    <text x="61" y="43" class="label">BY FARMING LABS</text>
+  </g>
+  <text x="1134" y="72" class="label" text-anchor="end">${escapeXml(brand)} \xB7 DOCUMENTATION</text>
+
+  <text x="71" y="198" class="mono bright" font-size="13" font-weight="650">DOCS</text>
+  <line x1="117" y1="193" x2="155" y2="193" stroke="#696969"/>
+  <text x="166" y="198" class="mono" fill="#9b9b9b" font-size="13">${escapeXml(section)}</text>
+  ${renderTextLines(titleLines, 71, titleY, titleLineHeight, `class="pixel bright" font-size="${titleSize}" font-weight="500" letter-spacing="-2.4"`)}
+  ${renderTextLines(descriptionLines, 71, descriptionY, 29, 'class="sans" fill="#a3a3a3" font-size="20" font-weight="430" letter-spacing="-.3"')}
+  <rect x="71" y="${routeY}" width="${Math.min(390, 56 + route.length * 8)}" height="36" fill="#050505" stroke="#3c3c3c"/>
+  <text x="85" y="${routeY + 23}" class="mono bright" font-size="11" font-weight="600">GET</text>
+  <text x="119" y="${routeY + 23}" class="mono" fill="#898989" font-size="11">${escapeXml(route)}</text>
+
+  ${renderIllustration(descriptor.illustration)}
+
+  <text x="71" y="570" class="mono bright" font-size="13" font-weight="550">${escapeXml(footerUrl)}</text>
+  <text x="1134" y="570" class="mono" fill="#9b9b9b" font-size="12" text-anchor="end">FARM.JS DOCUMENTATION</text>
+  <path d="M20 20h10M20 20v10M1180 20h-10M1180 20v10M20 610h10M20 610v-10M1180 610h-10M1180 610v-10" fill="none" stroke="#9b9b9b"/>
+</svg>`;
+}
+function renderFarmDocsSocialMetadata(descriptor, customImage) {
+  const imageUrl = customImage ? new URL(customImage, descriptor.pageUrl).href : descriptor.imageUrl;
+  const customExtension = customImage?.toLowerCase().split(/[?#]/, 1)[0];
+  const imageType = customExtension?.endsWith(".webp") ? "image/webp" : customExtension?.endsWith(".png") ? "image/png" : customExtension?.match(/\.jpe?g$/) ? "image/jpeg" : "image/svg+xml";
+  const tag = (property, content, name = false) => `<meta ${name ? "name" : "property"}="${property}" content="${escapeXml(content)}">`;
+  return [
+    tag("og:type", "article"),
+    tag("og:site_name", descriptor.siteName),
+    tag("og:title", descriptor.title),
+    tag("og:description", descriptor.description),
+    tag("og:url", descriptor.pageUrl),
+    tag("og:image", imageUrl),
+    tag("og:image:type", imageType),
+    ...customImage ? [] : [
+      tag("og:image:width", String(FARM_DOCS_SOCIAL_IMAGE_WIDTH)),
+      tag("og:image:height", String(FARM_DOCS_SOCIAL_IMAGE_HEIGHT))
+    ],
+    tag("og:image:alt", descriptor.imageAlt),
+    tag("twitter:card", "summary_large_image", true),
+    tag("twitter:title", descriptor.title, true),
+    tag("twitter:description", descriptor.description, true),
+    tag("twitter:image", imageUrl, true),
+    tag("twitter:image:alt", descriptor.imageAlt, true)
+  ].join("\n  ");
+}
+
+// src/docs/handler.ts
+var DOCS_FILE_NAMES = ["page.mdx", "page.md", "index.mdx", "index.md"];
+var DOCS_FILE_EXTENSIONS2 = [".mdx", ".md"];
+var FARM_DOCS_FALLBACK_FAVICON = "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'%3E%3Crect width='32' height='32' fill='black'/%3E%3Cpath d='M7 8h18v3H10v5h12v3H10v5H7z' fill='white'/%3E%3C/svg%3E";
+var FARM_DOCS_FAVICON_FILES = ["favicon.svg", "favicon.ico", "favicon.png"];
+function trimSlashes(value) {
+  return value.replace(/^\/+|\/+$/g, "");
+}
+function normalizeEntry2(entry) {
+  if (!entry || entry === "/") return "/";
+  return `/${trimSlashes(entry)}`;
+}
+function decodeDocsPath(value) {
+  try {
+    return decodeURIComponent(value);
+  } catch {
+    return value;
+  }
+}
+function normalizeSlug(value) {
+  return trimSlashes(decodeDocsPath(value)).replace(/\.(mdx?|markdown)$/i, "");
+}
+function resolveFarmDocsFavicon(docs, options) {
+  const configuredFavicon = docs?.config.favicon;
+  if (typeof configuredFavicon === "string" && configuredFavicon.trim()) {
+    return configuredFavicon.trim();
+  }
+  const publicDir = path2.join(path2.resolve(options.root), "public");
+  for (const fileName of FARM_DOCS_FAVICON_FILES) {
+    const faviconPath = path2.join(publicDir, fileName);
+    if (existsSync2(faviconPath) && statSync2(faviconPath).isFile()) {
+      return `/${fileName}`;
+    }
+  }
+  return FARM_DOCS_FALLBACK_FAVICON;
+}
+function renderFarmDocsFaviconLink(faviconHref) {
+  const normalizedHref = faviconHref.split(/[?#]/, 1)[0]?.toLowerCase() || "";
+  const type = normalizedHref.endsWith(".svg") || faviconHref.startsWith("data:image/svg+xml") ? "image/svg+xml" : normalizedHref.endsWith(".png") ? "image/png" : normalizedHref.endsWith(".ico") ? "image/x-icon" : void 0;
+  const metadata = type === "image/svg+xml" ? ' sizes="any" type="image/svg+xml"' : type ? ` type="${type}"` : "";
+  return `<link rel="icon" href="${escapeAttribute(faviconHref)}"${metadata}>`;
+}
+function renderFarmDocsBrandMark() {
+  return `<svg class="sidebar-brand-logo" viewBox="0 0 24 24" aria-hidden="true" focusable="false">
+    <rect x="2" y="2" width="5" height="5" rx="0.75" fill="currentColor"></rect>
+    <path d="M9.75 2h11.5c.41 0 .75.34.75.75v3.5c0 .41-.34.75-.75.75H9.75A.75.75 0 0 1 9 6.25v-3.5c0-.41.34-.75.75-.75Zm9.75 1.62a.38.38 0 0 0-.38.38v1c0 .21.17.38.38.38h.75c.21 0 .38-.17.38-.38V4a.38.38 0 0 0-.38-.38h-.75Z" fill="currentColor"></path>
+    <rect x="2" y="9.5" width="5" height="5" rx="0.75" fill="currentColor" opacity="0.64"></rect>
+    <rect x="9" y="9.5" width="13" height="5" rx="0.75" fill="currentColor" opacity="0.64"></rect>
+    <rect x="2" y="17" width="5" height="5" rx="0.75" fill="currentColor" opacity="0.34"></rect>
+    <rect x="9" y="17" width="7.5" height="5" rx="0.75" fill="currentColor" opacity="0.34"></rect>
+  </svg>`;
+}
+function renderFarmDocsBrandTitle(navTitle) {
+  const suffix = navTitle.match(/\.js$/i)?.[0];
+  if (!suffix) {
+    return `<span class="sidebar-brand-title">${escapeHtml(navTitle)}</span>`;
+  }
+  const productName = navTitle.slice(0, -suffix.length);
+  return `<span class="sidebar-brand-title">${escapeHtml(productName)}<span class="sidebar-brand-suffix">${escapeHtml(suffix)}</span></span>`;
+}
+function isSafeSegment(segment) {
+  return segment !== ".." && !segment.includes("/") && !segment.includes("\\");
+}
+function resolveInside(root, target) {
+  const resolvedRoot = path2.resolve(root);
+  const resolvedTarget = path2.resolve(target);
+  const relative = path2.relative(resolvedRoot, resolvedTarget);
+  if (relative === "" || !relative.startsWith("..") && !path2.isAbsolute(relative)) {
+    return resolvedTarget;
+  }
+  return null;
+}
+function resolveExistingFileInside(root, target) {
+  const safePath = resolveInside(root, target);
+  if (!safePath) return null;
+  try {
+    const realRoot = realpathSync2(root);
+    const realTarget = realpathSync2(safePath);
+    const containedTarget = resolveInside(realRoot, realTarget);
+    return containedTarget && statSync2(containedTarget).isFile() ? containedTarget : null;
+  } catch {
+    return null;
+  }
+}
+function isFarmDocsRequest(docs, request) {
+  if (!docs?.enabled) return false;
+  if (request.method !== "GET" && request.method !== "HEAD") return false;
+  const pathname = new URL(request.url).pathname;
+  const entry = normalizeEntry2(docs.entry);
+  if (entry === "/") return true;
+  return pathname === entry || pathname === `${entry}.md` || pathname.startsWith(`${entry}/`);
+}
+function resolveFarmDocsContentDir(docs, options) {
+  const root = path2.resolve(options.root);
+  const srcDir = options.srcDir || "src";
+  const configuredContentDir = docs.contentDir || docs.config.contentDir;
+  if (configuredContentDir) {
+    return path2.isAbsolute(configuredContentDir) ? configuredContentDir : path2.join(root, configuredContentDir);
+  }
+  const entryDir = docs.config.entry || trimSlashes(docs.entry) || "docs";
+  const appDocsDir = path2.join(root, srcDir, "app", entryDir);
+  if (existsSync2(appDocsDir)) return appDocsDir;
+  return path2.join(root, entryDir);
+}
+function getFarmDocsRouteTypeEntries(docs) {
+  if (!docs?.enabled) return [];
+  const entry = normalizeEntry2(docs.entry);
+  if (entry === "/") return ["/", "/[...docs]"];
+  return [entry, `${entry}/[...docs]`];
+}
+function getFarmDocsDocumentNavigationMatchers(docs) {
+  if (!docs?.enabled) return [];
+  const entry = normalizeEntry2(docs.entry);
+  return [entry === "/" ? "/(.*)" : `${entry}(.*)`];
+}
+function getRequestSlug(docs, request) {
+  const pathname = new URL(request.url).pathname;
+  const entry = normalizeEntry2(docs.entry);
+  if (entry === "/") return normalizeSlug(pathname);
+  if (pathname === entry || pathname === `${entry}.md`) return "";
+  return normalizeSlug(pathname.slice(entry.length));
+}
+function isDiscoverableDocsEntryName(name) {
+  return Boolean(name) && !name.startsWith(".") && name !== "node_modules";
+}
+function isDiscoverableDocsFile(contentDir, filePath) {
+  const segments = path2.relative(contentDir, filePath).split(path2.sep);
+  let dir = contentDir;
+  for (const [index, name] of segments.entries()) {
+    if (!isDiscoverableDocsEntryName(name)) return false;
+    let entry;
+    try {
+      entry = readdirSync2(dir, { withFileTypes: true }).find(
+        (candidate) => candidate.name === name
+      );
+    } catch {
+      return false;
+    }
+    const isLast = index === segments.length - 1;
+    if (!entry || !(isLast ? entry.isFile() : entry.isDirectory())) return false;
+    dir = path2.join(dir, name);
+  }
+  return true;
+}
+function findDocsPageFile(contentDir, slug) {
+  const canonicalSlug = trimSlashes(slug);
+  const segments = canonicalSlug ? canonicalSlug.split("/") : [];
+  if (!segments.every((segment) => isSafeSegment(segment) && isDiscoverableDocsEntryName(segment))) {
+    return null;
+  }
+  const slugDir = path2.join(contentDir, ...segments);
+  const candidates = segments.length === 0 ? DOCS_FILE_NAMES.map((filename) => path2.join(contentDir, filename)) : [
+    ...DOCS_FILE_NAMES.map((filename) => path2.join(slugDir, filename)),
+    ...DOCS_FILE_EXTENSIONS2.map(
+      (extension) => path2.join(contentDir, `${canonicalSlug}${extension}`)
+    )
+  ];
+  for (const candidate of candidates) {
+    if (pathToSlug(contentDir, candidate) !== canonicalSlug) continue;
+    if (!isDiscoverableDocsFile(contentDir, candidate)) continue;
+    const safePath = resolveExistingFileInside(contentDir, candidate);
+    if (safePath) {
+      return safePath;
+    }
+  }
+  return null;
+}
+function parseFrontmatter(source) {
+  if (!source.startsWith("---")) {
+    return { frontmatter: {}, body: source };
+  }
+  const endIndex = source.indexOf("\n---", 3);
+  if (endIndex === -1) return { frontmatter: {}, body: source };
+  const frontmatterSource = source.slice(3, endIndex).trim();
+  const body = source.slice(source.indexOf("\n", endIndex + 1) + 1);
+  const frontmatter = {};
+  for (const line of frontmatterSource.split(/\r?\n/)) {
+    const separator = line.indexOf(":");
+    if (separator === -1) continue;
+    const key = line.slice(0, separator).trim();
+    const value = line.slice(separator + 1).trim().replace(/^["']|["']$/g, "");
+    if (key && value) frontmatter[key] = value;
+  }
+  return { frontmatter, body };
+}
+function titleFromSlug(slug) {
+  const lastSegment = slug.split("/").filter(Boolean).pop() || "Docs";
+  return lastSegment.split(/[-_]/).filter(Boolean).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join(" ");
+}
+function titleFromMarkdown(body, fallback) {
+  const heading = body.match(/^#\s+(.+)$/m)?.[1]?.trim();
+  return heading || fallback;
+}
+function loadFarmDocsPage(contentDir, docs, slug) {
+  const sourcePath = findDocsPageFile(contentDir, slug);
+  if (!sourcePath) return null;
+  const source = readFileSync2(sourcePath, "utf8");
+  const { frontmatter, body } = parseFrontmatter(source);
+  const title = frontmatter.title || titleFromMarkdown(body, titleFromSlug(slug));
+  const href = createDocsHref(docs.entry, slug);
+  return {
+    slug,
+    title,
+    description: frontmatter.description,
+    section: frontmatter.section,
+    href,
+    sourcePath,
+    lastModified: resolveFarmDocsPageLastModified(contentDir, sourcePath, frontmatter),
+    frontmatter,
+    body
+  };
+}
+function getFarmDocsMarkdownPath(href) {
+  return href === "/" ? "/.md" : `${href}.md`;
+}
+function createDocsHref(entry, slug) {
+  const normalizedEntry = normalizeEntry2(entry);
+  const normalizedSlug = trimSlashes(slug);
+  if (normalizedEntry === "/") return normalizedSlug ? `/${normalizedSlug}` : "/";
+  return normalizedSlug ? `${normalizedEntry}/${normalizedSlug}` : normalizedEntry;
+}
+function pathToSlug(contentDir, filePath) {
+  const relative = path2.relative(contentDir, filePath).replace(/\\/g, "/");
+  if (relative.startsWith("..")) return null;
+  const extension = path2.extname(relative);
+  if (!DOCS_FILE_EXTENSIONS2.includes(extension)) return null;
+  const withoutExtension = relative.slice(0, -extension.length);
+  if (withoutExtension === "page" || withoutExtension === "index") return "";
+  if (withoutExtension.endsWith("/page") || withoutExtension.endsWith("/index")) {
+    return withoutExtension.replace(/\/(page|index)$/, "");
+  }
+  return withoutExtension;
+}
+function loadPage(contentDir, docs, request) {
+  return loadFarmDocsPage(contentDir, docs, getRequestSlug(docs, request));
+}
+function discoverFarmDocsPages(contentDir, docs) {
+  if (!existsSync2(contentDir)) return [];
+  const pages = [];
+  const visit = (dir) => {
+    for (const entry of readdirSync2(dir, { withFileTypes: true })) {
+      if (entry.name.startsWith(".") || entry.name === "node_modules") continue;
+      const absolutePath = path2.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        visit(absolutePath);
+        continue;
+      }
+      if (!entry.isFile()) continue;
+      const slug = pathToSlug(contentDir, absolutePath);
+      if (slug === null) continue;
+      const source = readFileSync2(absolutePath, "utf8");
+      const { frontmatter, body } = parseFrontmatter(source);
+      pages.push({
+        slug,
+        title: frontmatter.title || titleFromMarkdown(body, titleFromSlug(slug)),
+        description: frontmatter.description,
+        section: frontmatter.section,
+        href: createDocsHref(docs.entry, slug),
+        sourcePath: absolutePath,
+        lastModified: resolveFarmDocsPageLastModified(contentDir, absolutePath, frontmatter)
+      });
+    }
+  };
+  visit(contentDir);
+  return pages.sort((a, b) => a.href.localeCompare(b.href));
+}
+function toFarmDocsMarkdownPage(page) {
+  const lastModified = page.lastModified || page.frontmatter.lastModified || page.frontmatter.lastmod;
+  return {
+    slug: page.slug,
+    url: page.href,
+    title: page.title,
+    description: page.description,
+    lastModified,
+    lastmod: lastModified,
+    content: page.body,
+    rawContent: page.body
+  };
+}
+function getDocsTitle(docs) {
+  return typeof docs.config.nav === "object" && docs.config.nav && "title" in docs.config.nav ? String(docs.config.nav.title || "Documentation") : "Documentation";
+}
+function getDocsDescription(docs) {
+  return docs.config.metadata?.description;
+}
+function getLoadedDocsPages(contentDir, docs, isPathGuarded) {
+  return discoverFarmDocsPages(contentDir, docs).filter((page) => !isPathGuarded?.(page.href)).map((page) => loadFarmDocsPage(contentDir, docs, page.slug)).filter((page) => Boolean(page));
+}
+function toDocsLlmsPage(page) {
+  return toFarmDocsMarkdownPage(page);
+}
+function toDocsSitemapPage(page) {
+  return {
+    ...toFarmDocsMarkdownPage(page),
+    sourcePath: page.sourcePath
+  };
+}
+function resolvePageActionsConfig(docs) {
+  return isObjectRecord(docs.config.pageActions) ? docs.config.pageActions : {};
+}
+function resolvePageActionsAlignment(docs) {
+  return resolvePageActionsConfig(docs).alignment === "right" ? "right" : "left";
+}
+function resolveCopyMarkdownActionConfig(docs) {
+  const raw = resolvePageActionsConfig(docs).copyMarkdown;
+  if (raw === void 0 || raw === false) return null;
+  const options = isObjectRecord(raw) ? raw : {};
+  if (isObjectRecord(raw) && raw.enabled === false) return null;
+  return {
+    format: options.format === "text" ? "text" : "markdown",
+    includeTitle: options.includeTitle === true,
+    label: readString(options.label) ?? "Copy page",
+    copiedLabel: readString(options.copiedLabel) ?? "Copied!"
+  };
+}
+function resolveLastUpdatedDisplayConfig(docs) {
+  const raw = docs.config.lastUpdated;
+  const options = isObjectRecord(raw) ? raw : {};
+  return {
+    enabled: raw !== false && (!isObjectRecord(raw) || raw.enabled !== false),
+    label: typeof options.label === "string" ? options.label : "Last updated",
+    position: options.position === "below-title" ? "below-title" : "footer"
+  };
+}
+function formatLastModifiedDate(value) {
+  if (!value) return void 0;
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime())) return value;
+  return new Intl.DateTimeFormat("en", {
+    day: "numeric",
+    month: "long",
+    year: "numeric"
+  }).format(date);
+}
+function renderLastUpdatedText(page, docs, position) {
+  const config = resolveLastUpdatedDisplayConfig(docs);
+  const formatted = formatLastModifiedDate(page.lastModified);
+  if (!config.enabled || config.position !== position || !formatted) return "";
+  const time = `<time datetime="${escapeAttribute(page.lastModified || "")}">${escapeHtml(formatted)}</time>`;
+  const label = config.label.trim();
+  return label ? `${escapeHtml(label)} ${time}` : time;
+}
+function resolveReadingTimeDisplayConfig(docs) {
+  const raw = docs.config.readingTime;
+  if (raw === void 0 || raw === false) return null;
+  const options = isObjectRecord(raw) ? raw : {};
+  if (isObjectRecord(raw) && options.enabled === false) return null;
+  const wordsPerMinute = typeof options.wordsPerMinute === "number" && options.wordsPerMinute > 0 ? options.wordsPerMinute : 220;
+  return {
+    wordsPerMinute,
+    format: options.format === "short" ? "short" : "long",
+    includeCode: options.includeCode === true
+  };
+}
+function countMarkdownWords(body, includeCode) {
+  const readable = (includeCode ? body : body.replace(/```[\s\S]*?```/g, " ").replace(/`[^`]*`/g, " ")).replace(/!\[[^\]]*]\([^)]*\)/g, " ").replace(/\[([^\]]+)]\([^)]*\)/g, "$1").replace(/<[^>]+>/g, " ").replace(/[#>*_~`|:-]/g, " ");
+  return readable.match(/[A-Za-z0-9]+(?:[-'][A-Za-z0-9]+)*/g)?.length ?? 0;
+}
+function renderReadingTimeMeta(page, docs) {
+  const config = resolveReadingTimeDisplayConfig(docs);
+  if (!config) return "";
+  const words = countMarkdownWords(page.body, config.includeCode);
+  const minutes = Math.max(1, Math.ceil(words / config.wordsPerMinute));
+  const label = config.format === "short" ? `${minutes} min` : `${minutes} min read`;
+  return `<div class="fd-page-meta not-prose" data-page-reading-time>
+  <span class="fd-page-meta-dot" aria-hidden="true">\xB7</span>
+  <span class="fd-page-meta-item">${escapeHtml(label)}</span>
+</div>`;
+}
+function renderPixelPageActions(page, docs) {
+  const copyMarkdown = resolveCopyMarkdownActionConfig(docs);
+  if (!copyMarkdown) return "";
+  const markdownUrl = `${page.href}.md`;
+  const includeTitle = copyMarkdown.includeTitle ? "true" : "false";
+  return `<div class="fd-page-actions" data-page-actions data-actions-alignment="${resolvePageActionsAlignment(docs)}">
+  <button
+    type="button"
+    class="fd-page-action-btn"
+    data-page-action="copy-markdown"
+    data-copied="false"
+    data-markdown-url="${escapeAttribute(markdownUrl)}"
+    data-copy-markdown-format="${copyMarkdown.format}"
+    data-copy-markdown-include-title="${includeTitle}"
+    data-copy-label="${escapeAttribute(copyMarkdown.label)}"
+    data-copied-label="${escapeAttribute(copyMarkdown.copiedLabel)}"
+    aria-label="${escapeAttribute(copyMarkdown.label)}"
+    title="${escapeAttribute(copyMarkdown.label)}"
+  >
+    <svg class="fd-page-action-copy-icon" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><rect x="9" y="9" width="13" height="13" rx="2" ry="2"></rect><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"></path></svg>
+    <svg class="fd-page-action-check-icon" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M20 6 9 17l-5-5"></path></svg>
+    <span data-page-action-label>${escapeHtml(copyMarkdown.label)}</span>
+  </button>
+</div>`;
+}
+function renderBelowTitleMeta(page, docs) {
+  const lastUpdated = renderLastUpdatedText(page, docs, "below-title");
+  const actions = renderPixelPageActions(page, docs);
+  const readingTime = renderReadingTimeMeta(page, docs);
+  if (!lastUpdated && !actions && !readingTime) return "";
+  return `<div class="fd-below-title-block not-prose">
+  ${lastUpdated ? `<p class="fd-last-updated-inline">${lastUpdated}</p>` : ""}
+  ${actions}
+  ${readingTime}
+</div>`;
+}
+function renderMarkdownHtmlWithTitleMeta(page, docs, html) {
+  const meta = renderBelowTitleMeta(page, docs);
+  if (!meta) return html;
+  const withTitleMeta = html.replace(/(<h1\b[\s\S]*?<\/h1>)/, `$1
+${meta}`);
+  return withTitleMeta === html ? `${meta}
+${html}` : withTitleMeta;
+}
+function renderPixelPageFooter(page, docs) {
+  const lastUpdated = renderLastUpdatedText(page, docs, "footer");
+  if (!lastUpdated) return "";
+  return `<div class="not-prose fd-page-footer">
+  <span class="fd-last-updated-footer">${lastUpdated}</span>
+</div>`;
+}
+function getDocsLlmsOptions(docs, request) {
+  const configured = typeof docs.config.llmsTxt === "object" && docs.config.llmsTxt !== null ? docs.config.llmsTxt : {};
+  return {
+    enabled: true,
+    baseUrl: new URL(request.url).origin,
+    siteTitle: getDocsTitle(docs),
+    siteDescription: getDocsDescription(docs),
+    ...configured
+  };
+}
+function getDocsDiscoveryOptions(docs, request) {
+  return {
+    origin: new URL(request.url).origin,
+    entry: docs.entry,
+    i18n: null,
+    search: docs.config.search ?? true,
+    mcp: {
+      enabled: false,
+      route: "/api/docs/mcp",
+      name: `${getDocsTitle(docs)} MCP`,
+      version: "1",
+      tools: {
+        listDocs: false,
+        listPages: false,
+        readPage: false,
+        searchDocs: false,
+        getNavigation: false,
+        getCodeExamples: false,
+        getConfigSchema: false,
+        getContext: false
+      }
+    },
+    feedback: void 0,
+    llms: getDocsLlmsOptions(docs, request),
+    sitemap: docs.config.sitemap ?? true,
+    robots: docs.config.robots ?? true,
+    openapi: void 0,
+    markdown: {
+      acceptHeader: true,
+      signatureAgentHeader: true
+    }
+  };
+}
+function createFarmDocsPublicResponse(contentDir, docs, request, isPathGuarded) {
+  const url = new URL(request.url);
+  let loadedPages;
+  const getPages = () => loadedPages ?? (loadedPages = getLoadedDocsPages(contentDir, docs, isPathGuarded));
+  const sitemapManifest = () => docsEngine().buildDocsSitemapManifest({
+    pages: getPages().map(toDocsSitemapPage),
+    entry: docs.entry,
+    siteTitle: getDocsTitle(docs),
+    baseUrl: url.origin
+  });
+  const textHeaders = (contentType) => ({
+    "Content-Type": contentType,
+    "Cache-Control": "public, max-age=60"
+  });
+  const llmsFormat = docsEngine().resolveDocsLlmsTxtFormat(url);
+  if (llmsFormat) {
+    const generated = docsEngine().renderDocsLlmsTxt(
+      getPages().map(toDocsLlmsPage),
+      getDocsLlmsOptions(docs, request)
+    );
+    return new Response(llmsFormat === "llms-full" ? generated.llmsFullTxt : generated.llmsTxt, {
+      status: 200,
+      headers: textHeaders("text/plain; charset=utf-8")
+    });
+  }
+  const sitemapFormat = docsEngine().resolveDocsSitemapRequest(url, docs.config.sitemap ?? true);
+  if (sitemapFormat === "xml") {
+    return new Response(
+      docsEngine().renderDocsSitemapXml(sitemapManifest(), {
+        baseUrl: url.origin,
+        includeLastmod: true
+      }),
+      {
+        status: 200,
+        headers: textHeaders("application/xml; charset=utf-8")
+      }
+    );
+  }
+  if (sitemapFormat === "markdown") {
+    return new Response(
+      docsEngine().renderDocsSitemapMarkdown(sitemapManifest(), {
+        includeDescriptions: true
+      }),
+      {
+        status: 200,
+        headers: textHeaders("text/markdown; charset=utf-8")
+      }
+    );
+  }
+  if (docsEngine().resolveDocsRobotsRequest(url, docs.config.robots ?? true)) {
+    return new Response(
+      docsEngine().renderDocsRobotsTxt({
+        entry: docs.entry,
+        sitemap: docs.config.sitemap ?? true,
+        robots: docs.config.robots ?? true,
+        baseUrl: url.origin
+      }),
+      {
+        status: 200,
+        headers: textHeaders("text/plain; charset=utf-8")
+      }
+    );
+  }
+  if (docsEngine().isDocsAgentDiscoveryRequest(url)) {
+    const spec = docsEngine().buildDocsAgentDiscoverySpec(getDocsDiscoveryOptions(docs, request));
+    const title = getDocsTitle(docs);
+    return new Response(
+      JSON.stringify({
+        ...spec,
+        name: title,
+        site: {
+          ...spec.site,
+          title,
+          description: getDocsDescription(docs),
+          entry: docs.entry
+        }
+      }),
+      {
+        status: 200,
+        headers: textHeaders("application/json; charset=utf-8")
+      }
+    );
+  }
+  if (docsEngine().isDocsAgentsRequest(url)) {
+    return new Response(
+      `${docsEngine().renderDocsAgentsDocument(getDocsDiscoveryOptions(docs, request)).trim()}
+`,
+      {
+        status: 200,
+        headers: textHeaders("text/markdown; charset=utf-8")
+      }
+    );
+  }
+  if (docsEngine().isDocsSkillRequest(url)) {
+    return new Response(
+      `${docsEngine().renderDocsSkillDocument(getDocsDiscoveryOptions(docs, request)).trim()}
+`,
+      {
+        status: 200,
+        headers: textHeaders("text/markdown; charset=utf-8")
+      }
+    );
+  }
+  return null;
+}
+function omitFarmDocsHeadBody(request, response) {
+  if (request.method !== "HEAD") return response;
+  return new Response(null, {
+    status: response.status,
+    statusText: response.statusText,
+    headers: response.headers
+  });
+}
+function escapeHtml(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+function shouldReturnMarkdown(request) {
+  const url = new URL(request.url);
+  if (url.pathname.endsWith(".md")) return true;
+  const accept = request.headers.get("accept");
+  const markdown = Math.max(
+    farmAcceptQuality(accept, "text/markdown"),
+    farmAcceptQuality(accept, "text/plain")
+  );
+  if (markdown <= 0) return false;
+  return markdown >= farmAcceptQuality(accept, "text/html", { wildcards: true });
+}
+function escapeAttribute(value) {
+  return escapeHtml(value).replace(/'/g, "&#39;");
+}
+function slugify(value) {
+  return value.toLowerCase().replace(/<[^>]+>/g, "").replace(/`([^`]+)`/g, "$1").replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+}
+function createSlugger() {
+  const seen = /* @__PURE__ */ new Map();
+  return (value) => {
+    const base = slugify(value) || "section";
+    const count = seen.get(base) || 0;
+    seen.set(base, count + 1);
+    return count === 0 ? base : `${base}-${count + 1}`;
+  };
+}
+function stripHtml(value) {
+  return value.replace(/<[^>]+>/g, "");
+}
+function getCodeFence(line) {
+  const match = /^(?: {0,3})(`{3,}|~{3,})/.exec(line);
+  const value = match?.[1];
+  if (!value) return null;
+  return { marker: value[0], length: value.length };
+}
+function isClosingCodeFence(line, fence) {
+  const trimmed = line.trim();
+  return trimmed.length >= fence.length && Array.from(trimmed).every((char) => char === fence.marker);
+}
+function stripMdxRuntimeSyntax(body) {
+  const output = [];
+  let fence = null;
+  for (const line of body.split("\n")) {
+    const nextFence = getCodeFence(line);
+    if (fence) {
+      output.push(line);
+      if (nextFence && nextFence.marker === fence.marker && isClosingCodeFence(line, fence)) {
+        fence = null;
+      }
+      continue;
+    }
+    if (nextFence) {
+      fence = nextFence;
+      output.push(line);
+      continue;
+    }
+    if (/^\s*import\s.+$/.test(line) || /^\s*export\s+(const|default)\s.+$/.test(line)) {
+      continue;
+    }
+    output.push(line);
+  }
+  return output.join("\n");
+}
+function unescapeHtml(value) {
+  return value.replace(/&quot;/g, '"').replace(/&#39;/g, "'").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&");
+}
+var CODE_LANGUAGE_LABELS = /* @__PURE__ */ new Set([
+  "bash",
+  "cjs",
+  "cmd",
+  "console",
+  "css",
+  "html",
+  "javascript",
+  "js",
+  "json",
+  "jsx",
+  "md",
+  "mdx",
+  "shell",
+  "sh",
+  "terminal",
+  "text",
+  "ts",
+  "tsx",
+  "txt",
+  "typescript",
+  "yaml",
+  "yml",
+  "zsh"
+]);
+var EXTENSIONLESS_CODE_FILENAMES = /* @__PURE__ */ new Set([
+  "dockerfile",
+  "makefile",
+  "procfile",
+  "readme",
+  "license"
+]);
+function isCodePathLabel(label) {
+  const trimmed = label.trim();
+  if (!trimmed || /\s/.test(trimmed)) return false;
+  const lower = trimmed.toLowerCase();
+  if (CODE_LANGUAGE_LABELS.has(lower)) return false;
+  const fileName = trimmed.split(/[\\/]/).filter(Boolean).pop() || trimmed;
+  const lowerFileName = fileName.toLowerCase();
+  if (EXTENSIONLESS_CODE_FILENAMES.has(lowerFileName)) return true;
+  if (fileName.startsWith(".") && fileName.length > 1) return true;
+  return /\.[a-z0-9][a-z0-9-]*$/i.test(fileName);
+}
+function parseCodeInfo(info) {
+  const source = (info || "").trim();
+  const language = source.match(/^\S+/)?.[0] || "text";
+  const explicitLabel = source.match(/\b(?:title|filename|file|label|name)=["']([^"']+)["']/)?.[1]?.trim();
+  return { language, label: explicitLabel || language, hasExplicitLabel: Boolean(explicitLabel) };
+}
+function getStandaloneCodeLabel(line) {
+  const trimmed = line.trim();
+  const match = /^(?:\*\*([^*]+)\*\*|__([^_]+)__|`([^`]+)`)$/u.exec(trimmed);
+  const label = match?.[1] || match?.[2] || match?.[3];
+  return label?.trim() || null;
+}
+function hasCodeFenceTitle(info) {
+  return /\b(?:title|filename|file|label|name)=["'][^"']+["']/.test(info);
+}
+function escapeCodeFenceTitle(value) {
+  return value.replace(/"/g, "&quot;");
+}
+function addTitleToCodeFence(line, title) {
+  const match = /^(\s{0,3})(`{3,}|~{3,})(.*)$/u.exec(line);
+  if (!match) return line;
+  const [, indent, marker, infoSource] = match;
+  const info = infoSource.trim();
+  if (hasCodeFenceTitle(info)) return line;
+  const suffix = `title="${escapeCodeFenceTitle(title)}"`;
+  return `${indent}${marker}${info ? `${info} ${suffix}` : `text ${suffix}`}`;
+}
+function attachCodeBlockLabels(body) {
+  const lines = body.split("\n");
+  const output = [];
+  let fence = null;
+  for (let index = 0; index < lines.length; index += 1) {
+    const line = lines[index] || "";
+    const nextFence = getCodeFence(line);
+    if (fence) {
+      output.push(line);
+      if (nextFence && nextFence.marker === fence.marker && isClosingCodeFence(line, fence)) {
+        fence = null;
+      }
+      continue;
+    }
+    if (nextFence) {
+      fence = nextFence;
+      output.push(line);
+      continue;
+    }
+    const label = getStandaloneCodeLabel(line);
+    if (!label) {
+      output.push(line);
+      continue;
+    }
+    let fenceIndex = index + 1;
+    while (fenceIndex < lines.length && (lines[fenceIndex] || "").trim() === "") {
+      fenceIndex += 1;
+    }
+    const labeledFence = getCodeFence(lines[fenceIndex] || "");
+    if (!labeledFence) {
+      output.push(line);
+      continue;
+    }
+    output.push(addTitleToCodeFence(lines[fenceIndex] || "", label));
+    fence = labeledFence;
+    index = fenceIndex;
+  }
+  return output.join("\n");
+}
+function highlightCodeBlock(code) {
+  return highlight(code.replace(/\n$/, "")).replace(/<\/span>\n<span/g, "</span><span");
+}
+function renderCodeCopyButton(className = "code-copy") {
+  return `<button class="${className}" type="button" data-code-copy data-copied="false" aria-label="Copy code" title="Copy code"><svg class="code-copy-icon" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><rect x="9" y="9" width="13" height="13" rx="2" ry="2"></rect><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"></path></svg><svg class="code-copy-check" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M20 6 9 17l-5-5"></path></svg></button>`;
+}
+function renderMarkdownDocument(body, depth) {
+  const slug = createSlugger();
+  const renderer = new Renderer();
+  const maxLevel = Math.max(2, Math.min(depth, 6));
+  const tocItems = [];
+  renderer.heading = (text, level, raw) => {
+    const title = raw || stripHtml(text);
+    const id = slug(title);
+    if (level >= 2 && level <= maxLevel) {
+      tocItems.push({ id, title, level });
+    }
+    return `<h${level} id="${escapeAttribute(id)}"><a class="heading-anchor" href="#${escapeAttribute(id)}">${text}</a></h${level}>
+`;
+  };
+  renderer.code = (code, infostring, escaped) => {
+    const { language, label, hasExplicitLabel } = parseCodeInfo(infostring);
+    const rawCode = escaped ? unescapeHtml(code) : code;
+    const highlighted = highlightCodeBlock(rawCode);
+    const shouldRenderHeader = hasExplicitLabel && isCodePathLabel(label);
+    const header = shouldRenderHeader ? `<div class="code-block-header">
+    <span class="code-block-title">${escapeHtml(label)}</span>
+    ${renderCodeCopyButton()}
+  </div>` : renderCodeCopyButton("code-copy code-copy-floating");
+    return `<figure class="shiki code-block ${shouldRenderHeader ? "code-block-framed" : "code-block-plain"}" data-language="${escapeAttribute(language)}">
+  ${header}
+  <pre><code class="sh-code language-${escapeAttribute(language)}">${highlighted}</code></pre>
+</figure>
+`;
+  };
+  renderer.table = (header, body2) => `<div class="fd-table-wrapper table-wrap relative overflow-auto prose-no-margin my-6"><table><thead>${header}</thead><tbody>${body2}</tbody></table></div>
+`;
+  renderer.blockquote = (quote) => `<blockquote>${quote}</blockquote>
+`;
+  renderer.codespan = (code) => `<code>${escapeHtml(code)}</code>`;
+  renderer.link = (href, title, text) => {
+    const safeHref = href || "";
+    const titleAttribute = title ? ` title="${escapeAttribute(title)}"` : "";
+    return `<a href="${escapeAttribute(safeHref)}"${titleAttribute}>${text}</a>`;
+  };
+  renderer.image = (href, title, text) => {
+    const titleAttribute = title ? ` title="${escapeAttribute(title)}"` : "";
+    return `<img src="${escapeAttribute(href)}" alt="${escapeAttribute(text)}"${titleAttribute}>`;
+  };
+  const html = marked(attachCodeBlockLabels(stripMdxRuntimeSyntax(body)), {
+    async: false,
+    breaks: false,
+    gfm: true,
+    renderer
+  });
+  return { html: html.trim(), tocItems };
+}
+function getThemeUI(docs) {
+  const theme = docs.config.theme;
+  return theme && typeof theme === "object" && "ui" in theme && typeof theme.ui === "object" ? theme.ui : {};
+}
+function getThemeName(docs) {
+  const theme = docs.config.theme;
+  return theme && typeof theme === "object" && "name" in theme ? String(theme.name || "farm-docs") : "farm-docs";
+}
+function getThemeTocDepth(docs) {
+  const toc = getThemeUI(docs).layout?.toc;
+  return toc && typeof toc === "object" && typeof toc.depth === "number" ? toc.depth : 3;
+}
+var SIDEBAR_SECTION_ORDER = [
+  "Start",
+  "Core",
+  "Data and APIs",
+  "Integrations",
+  "Runtime",
+  "Content",
+  "Extending",
+  "Reference"
+];
+var SIDEBAR_PAGE_ORDER = new Map(
+  [
+    "",
+    "getting-started",
+    "project-structure",
+    "configuration",
+    "routing",
+    "layouts",
+    "server-rendering",
+    "middleware",
+    "query",
+    "api-routes",
+    "api-client",
+    "storage",
+    "integrations",
+    "integrations/stripe",
+    "integrations/autumn",
+    "integrations/polar",
+    "integrations/auth",
+    "integrations/email",
+    "integrations/jobs",
+    "integrations/unkey",
+    "integrations/ui-registry",
+    "integrations/orm-storage",
+    "cache-ppr",
+    "observability",
+    "deployment",
+    "docs-engine",
+    "markdown",
+    "openapi",
+    "plugins",
+    "plugins/create-plugin",
+    "cli",
+    "examples",
+    "reference"
+  ].map((slug, index) => [slug, index])
+);
+function isSidebarNavigationItem(value) {
+  return value !== null;
+}
+function compareSidebarPages(a, b) {
+  const aOrder = SIDEBAR_PAGE_ORDER.get(a.slug) ?? 1e3;
+  const bOrder = SIDEBAR_PAGE_ORDER.get(b.slug) ?? 1e3;
+  return aOrder - bOrder || a.title.localeCompare(b.title);
+}
+function getSidebarSection(page) {
+  if (page.section) return page.section;
+  if (page.slug.startsWith("integrations/")) return "Integrations";
+  if (page.slug.startsWith("plugins/")) return "Extending";
+  return "Reference";
+}
+function sidebarIdFor(section) {
+  return `sidebar-${slugify(section)}`;
+}
+function isObjectRecord(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function readString(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+function readOptionalString(value) {
+  return typeof value === "string" ? value.trim() : void 0;
+}
+function normalizeSidebarSlug(value) {
+  if (value === "/" || value === ".") return "";
+  return trimSlashes(value);
+}
+function getSidebarNavigation(docs) {
+  const navigation = docs.config.navigation;
+  if (!isObjectRecord(navigation) || !Array.isArray(navigation.sidebar)) return [];
+  return navigation.sidebar.map(normalizeSidebarNavigationItem).filter(isSidebarNavigationItem);
+}
+function normalizeSidebarNavigationItem(value) {
+  if (!isObjectRecord(value)) return null;
+  const label = readString(value.label) ?? readString(value.title);
+  const icon = readString(value.icon);
+  const slug = readOptionalString(value.slug) ?? readOptionalString(value.path);
+  const href = readString(value.href) ?? readString(value.url);
+  const rawChildren = Array.isArray(value.children) ? value.children : Array.isArray(value.items) ? value.items : [];
+  const children = rawChildren.map(normalizeSidebarNavigationItem).filter(isSidebarNavigationItem);
+  if (!label && !slug && !href && children.length === 0) return null;
+  return {
+    ...label ? { label } : {},
+    ...icon ? { icon } : {},
+    ...slug !== void 0 ? { slug: normalizeSidebarSlug(slug) } : {},
+    ...href ? { href } : {},
+    children
+  };
+}
+function createSidebarPageMaps(pages) {
+  return {
+    bySlug: new Map(pages.map((page) => [page.slug, page])),
+    byHref: new Map(pages.map((page) => [page.href, page]))
+  };
+}
+function resolveConfiguredSidebarPage(item, maps) {
+  if (item.slug !== void 0) return maps.bySlug.get(item.slug);
+  if (item.href) return maps.byHref.get(item.href);
+  return void 0;
+}
+function getSidebarIconRegistry(docs) {
+  return isObjectRecord(docs.config.icons) ? docs.config.icons : {};
+}
+function renderConfiguredIconSvg(value) {
+  if (typeof value !== "string") return "";
+  const icon = value.trim();
+  if (!icon) return "";
+  if (/^<svg[\s>]/i.test(icon)) return icon;
+  if (/^<(path|circle|rect|line|polyline|polygon|ellipse|g)\b/i.test(icon)) {
+    return `<svg viewBox="0 0 24 24" focusable="false">${icon}</svg>`;
+  }
+  return "";
+}
+function renderSidebarIcon(docs, icon, className = "sidebar-icon fd-sidebar-icon") {
+  if (!icon) return "";
+  const iconRegistry = getSidebarIconRegistry(docs);
+  const configuredIcon = iconRegistry[icon] ?? icon;
+  const svg = renderConfiguredIconSvg(configuredIcon);
+  if (!svg) return "";
+  return `<span class="${className}" data-sidebar-icon="${escapeAttribute(icon)}" aria-hidden="true">${svg}</span>`;
+}
+function renderSidebarLabel(docs, icon, label, className) {
+  return `<span class="${className}">${renderSidebarIcon(docs, icon)}<span class="sidebar-label-text">${escapeHtml(label)}</span></span>`;
+}
+function getSidebarPageLabel(item, configured) {
+  if (configured?.label) return configured.label;
+  if (item.slug === "") return "Why?";
+  if (item.slug === "integrations") return "Overview";
+  if (item.slug === "integrations/ui-registry") return "UI Registry";
+  if (item.slug === "integrations/orm-storage") return "ORM Storage";
+  if (item.slug.startsWith("integrations/")) {
+    return item.title.replace(/\s+Integrations?$/i, "");
+  }
+  return item.title;
+}
+function renderSidebarLink(item, activeHref, docs, configured) {
+  const active = item.href === activeHref;
+  return `<a class="fd-sidebar-link${active ? " fd-sidebar-link-active" : ""}" data-active="${active ? "true" : "false"}" href="${escapeAttribute(item.href)}">${renderSidebarLabel(docs, configured?.icon, getSidebarPageLabel(item, configured), "sidebar-link-label fd-sidebar-link-label")}</a>`;
+}
+function collectConfiguredSidebarPages(items, maps, seen = /* @__PURE__ */ new Set()) {
+  const ordered = [];
+  for (const item of items) {
+    const page = resolveConfiguredSidebarPage(item, maps);
+    if (page && !seen.has(page.slug)) {
+      seen.add(page.slug);
+      ordered.push(page);
+    }
+    ordered.push(...collectConfiguredSidebarPages(item.children, maps, seen));
+  }
+  return ordered;
+}
+function getOrderedSidebarPages(pages, docs) {
+  if (!docs) return [...pages].sort(compareSidebarPages);
+  const maps = createSidebarPageMaps(pages);
+  const configuredPages = collectConfiguredSidebarPages(getSidebarNavigation(docs), maps);
+  if (configuredPages.length === 0) return [...pages].sort(compareSidebarPages);
+  const configuredSlugs = new Set(configuredPages.map((page) => page.slug));
+  const remainingPages = pages.filter((page) => !configuredSlugs.has(page.slug)).sort(compareSidebarPages);
+  return [...configuredPages, ...remainingPages];
+}
+function renderExternalSidebarLink(item, activeHref, docs) {
+  if (!item.href || !item.label) return "";
+  const active = item.href === activeHref;
+  return `<a class="fd-sidebar-link${active ? " fd-sidebar-link-active" : ""}" data-active="${active ? "true" : "false"}" href="${escapeAttribute(item.href)}">${renderSidebarLabel(docs, item.icon, item.label, "sidebar-link-label fd-sidebar-link-label")}</a>`;
+}
+function renderConfiguredSidebarSubgroup(item, childHtml, docs) {
+  const label = item.label;
+  if (!label) return childHtml;
+  return `<div class="sidebar-subgroup fd-sidebar-folder" data-sidebar-subgroup="${escapeAttribute(slugify(label))}">
+  <div class="sidebar-subgroup-title fd-sidebar-folder-trigger">${renderSidebarLabel(docs, item.icon, label, "sidebar-subgroup-label")}</div>
+  <div class="sidebar-subgroup-content fd-sidebar-folder-content">
+${childHtml}
+  </div>
+</div>`;
+}
+function renderConfiguredSidebarItems(items, maps, activeHref, docs) {
+  const renderedItems = [];
+  for (const item of items) {
+    const page = resolveConfiguredSidebarPage(item, maps);
+    const childHtml = renderConfiguredSidebarItems(item.children, maps, activeHref, docs);
+    if (item.children.length > 0) {
+      renderedItems.push(renderConfiguredSidebarSubgroup(item, childHtml, docs));
+      continue;
+    }
+    const linkHtml = page ? renderSidebarLink(page, activeHref, docs, item) : renderExternalSidebarLink(item, activeHref, docs);
+    if (linkHtml) renderedItems.push(linkHtml);
+  }
+  return renderedItems.join("\n");
+}
+function renderConfiguredSidebarSection(section, maps, activeHref, docs) {
+  const label = section.label || "Docs";
+  const id = sidebarIdFor(label);
+  const links = renderConfiguredSidebarItems(section.children, maps, activeHref, docs);
+  return `<div class="sidebar-folder fd-sidebar-folder" data-state="open">
+  <button class="text-fd-muted-foreground sidebar-folder-trigger fd-sidebar-folder-trigger" type="button" aria-controls="${escapeAttribute(id)}" aria-expanded="true">${renderSidebarLabel(docs, section.icon, label, "sidebar-folder-label")}</button>
+  <div id="${escapeAttribute(id)}" class="overflow-hidden sidebar-folder-content fd-sidebar-folder-content" data-state="open">
+${links}
+  </div>
+</div>`;
+}
+function renderAutoSidebarSectionItems(items, activeHref, docs) {
+  return [...items].sort(compareSidebarPages).map((item) => renderSidebarLink(item, activeHref, docs)).join("\n");
+}
+function renderPixelNavItems(pages, activeHref, docs) {
+  const configuredSidebar = getSidebarNavigation(docs);
+  if (configuredSidebar.length > 0) {
+    const maps = createSidebarPageMaps(pages);
+    const renderedSections2 = configuredSidebar.map((section) => {
+      if (section.children.length > 0) {
+        return renderConfiguredSidebarSection(section, maps, activeHref, docs);
+      }
+      const page = resolveConfiguredSidebarPage(section, maps);
+      return page ? renderSidebarLink(page, activeHref, docs, section) : renderExternalSidebarLink(section, activeHref, docs);
+    }).filter(Boolean).join("\n");
+    return `<div class="sidebar-scroll overscroll-contain fd-sidebar-nav">
+  <div class="sidebar-tree">
+${renderedSections2}
+  </div>
+</div>`;
+  }
+  const groups = /* @__PURE__ */ new Map();
+  for (const item of pages) {
+    const group = item.slug === "" ? "Start" : getSidebarSection(item);
+    const entries = groups.get(group) ?? [];
+    entries.push(item);
+    groups.set(group, entries);
+  }
+  const renderedSections = Array.from(groups.entries()).sort(([a], [b]) => {
+    const aOrder = SIDEBAR_SECTION_ORDER.indexOf(a);
+    const bOrder = SIDEBAR_SECTION_ORDER.indexOf(b);
+    return (aOrder === -1 ? 100 : aOrder) - (bOrder === -1 ? 100 : bOrder) || a.localeCompare(b);
+  }).map(([section, items]) => {
+    const id = sidebarIdFor(section);
+    const links = renderAutoSidebarSectionItems(items, activeHref, docs);
+    return `<div class="sidebar-folder fd-sidebar-folder" data-state="open">
+  <button class="text-fd-muted-foreground sidebar-folder-trigger fd-sidebar-folder-trigger" type="button" aria-controls="${escapeAttribute(id)}" aria-expanded="true">${renderSidebarLabel(docs, void 0, section, "sidebar-folder-label")}</button>
+  <div id="${escapeAttribute(id)}" class="overflow-hidden sidebar-folder-content fd-sidebar-folder-content" data-state="open">
+${links}
+  </div>
+</div>`;
+  }).join("\n");
+  return `<div class="sidebar-scroll overscroll-contain fd-sidebar-nav">
+  <div class="sidebar-tree">
+${renderedSections}
+  </div>
+</div>`;
+}
+function renderPixelPageNav(pages, activeHref, docs) {
+  const orderedPages = getOrderedSidebarPages(pages, docs);
+  const activeIndex = orderedPages.findIndex((item) => item.href === activeHref);
+  if (activeIndex === -1) return "";
+  const previous = orderedPages[activeIndex - 1];
+  const next = orderedPages[activeIndex + 1];
+  if (!previous && !next) return "";
+  const renderChevron = (direction) => `<svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><polyline points="${direction === "prev" ? "15 18 9 12 15 6" : "9 18 15 12 9 6"}" /></svg>`;
+  const renderCard = (item, direction) => `<a class="fd-page-nav-card fd-page-nav-${direction}" href="${escapeAttribute(item.href)}">
+  <span class="fd-page-nav-title fd-page-nav-title-${direction}">${direction === "prev" ? `${renderChevron(direction)}${escapeHtml(item.title)}` : `${escapeHtml(item.title)}${renderChevron(direction)}`}</span>
+  <span class="fd-page-nav-description">${direction === "prev" ? "Previous Page" : "Next Page"}</span>
+</a>`;
+  return `<nav class="not-prose fd-page-nav" aria-label="Page navigation">
+  ${previous ? renderCard(previous, "prev") : ""}
+  ${next ? renderCard(next, "next") : ""}
+</nav>`;
+}
+function titleizePathSegment(value) {
+  return value.replace(/[-_]+/g, " ").replace(/\b\w/g, (character) => character.toUpperCase());
+}
+function isBreadcrumbEnabled(docs) {
+  const breadcrumb = docs.config.breadcrumb;
+  if (breadcrumb === false) return false;
+  if (breadcrumb && typeof breadcrumb === "object" && "enabled" in breadcrumb) {
+    return breadcrumb.enabled !== false;
+  }
+  return true;
+}
+function renderPixelBreadcrumb(page, docs) {
+  if (!isBreadcrumbEnabled(docs)) return "";
+  const segments = trimSlashes(page.slug).split("/").filter(Boolean);
+  if (segments.length < 2) return "";
+  const parentSegments = segments.slice(0, -1);
+  const parentSegment = parentSegments[parentSegments.length - 1];
+  const currentSegment = segments[segments.length - 1];
+  const entry = normalizeEntry2(docs.entry);
+  const parentPath = parentSegments.join("/");
+  const parentHref = entry === "/" ? `/${parentPath}` : `${entry}/${parentPath}`;
+  return `<nav class="fd-breadcrumb" aria-label="Breadcrumb">
+  <span class="fd-breadcrumb-item">
+    <a class="fd-breadcrumb-parent fd-breadcrumb-link" href="${escapeAttribute(parentHref)}">${escapeHtml(titleizePathSegment(parentSegment))}</a>
+  </span>
+  <span class="fd-breadcrumb-item">
+    <span class="fd-breadcrumb-sep">/</span>
+    <span class="fd-breadcrumb-current">${escapeHtml(titleizePathSegment(currentSegment))}</span>
+  </span>
+</nav>`;
+}
+function renderDocsSearchTrigger(showIcon = true, className = "") {
+  return `<button class="fd-docs-search-trigger ${className}" type="button" data-search-full="" aria-label="Search documentation" aria-haspopup="dialog" aria-keyshortcuts="Meta+K Control+K">
+  ${showIcon ? '<svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><circle cx="11" cy="11" r="7"></circle><path d="m20 20-4-4"></path></svg>' : ""}
+  <kbd><span>\u2318</span><span>K</span></kbd>
+</button>`;
+}
+function renderDocsSearchMount(clientEntry) {
+  return `<div id="farm-docs-search-root" data-farm-docs-search-root data-api="/api/docs"></div>
+  ${stampFarmCspNonce(`<script type="module" src="${escapeAttribute(clientEntry)}"></script>`)}`;
+}
+function renderDocsSearchBootstrapScript() {
+  return stampFarmCspNonce(`<script>${generateFarmDocsSearchBootstrapRuntime()}</script>`);
+}
+function renderPixelToc(items) {
+  if (items.length === 0) return '<p class="toc-empty">No sections</p>';
+  return `<div class="toc-track fd-toc-list">
+  <div class="toc-thumb" data-toc-thumb style="clip-path: polygon(0 0px, 100% 0px, 100% 32px, 0 32px);"></div>
+  <div class="toc-links">
+${items.map(
+    (item) => `<a class="toc-link fd-toc-link${items[0] === item ? " fd-toc-link-active" : ""}" data-active="${items[0] === item ? "true" : "false"}" data-toc-item data-depth="${item.level}" href="#${escapeAttribute(item.id)}">${escapeHtml(item.title)}</a>`
+  ).join("\n")}
+  </div>
+</div>`;
+}
+function renderDocsRuntimeScript(docs) {
+  const docsEntry = JSON.stringify(normalizeEntry2(docs.entry));
+  const reconcileHeadRuntime = `const farmNavigationHeadSelector=${JSON.stringify(FARM_NAVIGATION_HEAD_SELECTOR)};const reconcileDocsHead=(nextDoc)=>{const nextTitle=nextDoc.querySelector("title");document.title=nextTitle?.textContent||"";document.head.querySelectorAll(farmNavigationHeadSelector).forEach((node)=>node.remove());nextDoc.head.querySelectorAll(farmNavigationHeadSelector).forEach((node)=>document.head.appendChild(document.importNode(node,true)))}`;
+  return `<script>(()=>{if(window.__farmDocsRuntime)return;window.__farmDocsRuntime=true;document.documentElement.dataset.farmDocsRuntime="true";document.documentElement.dataset.farmDocsRuntimeId=Math.random().toString(36).slice(2);${reconcileHeadRuntime};const docsEntry=${docsEntry};let cleanupToc=()=>{};let closeMobileSidebar=()=>{};const normalizePath=(path)=>path.length>1?path.replace(/\\/+$/,""):path;const isDocsPath=(path)=>{const next=normalizePath(path);const entry=normalizePath(docsEntry);if(next.endsWith(".md"))return false;if(entry==="/")return true;return next===entry||next.startsWith(entry+"/")};const initToc=()=>{cleanupToc();const toc=document.getElementById("nd-toc");if(!toc){cleanupToc=()=>{};return}const links=Array.from(toc.querySelectorAll("[data-toc-item]"));const thumb=toc.querySelector("[data-toc-thumb]");const pairs=links.map((link)=>{let id=link.hash.slice(1);try{id=decodeURIComponent(id)}catch{}return{link,heading:document.getElementById(id)}}).filter((item)=>item.heading);const setActive=(active)=>{for(const {link} of pairs){const selected=link===active.link;link.dataset.active=selected?"true":"false";link.classList.toggle("fd-toc-link-active",selected)}if(!thumb)return;const styles=getComputedStyle(active.link);const top=active.link.offsetTop+parseFloat(styles.paddingTop||"0");const bottom=active.link.offsetTop+active.link.clientHeight-parseFloat(styles.paddingBottom||"0");thumb.style.clipPath="polygon(0 "+top+"px,100% "+top+"px,100% "+bottom+"px,0 "+bottom+"px)"};const update=()=>{if(pairs.length===0)return;const offset=Math.min(window.innerHeight*0.3,160);let active=pairs[0];for(const pair of pairs){if(pair.heading.getBoundingClientRect().top<=offset)active=pair;else break}setActive(active)};let frame=0;const schedule=()=>{if(frame)return;frame=requestAnimationFrame(()=>{frame=0;update()})};const onHashChange=()=>setTimeout(schedule,0);window.addEventListener("scroll",schedule,{passive:true});window.addEventListener("resize",schedule);window.addEventListener("hashchange",onHashChange);cleanupToc=()=>{window.removeEventListener("scroll",schedule);window.removeEventListener("resize",schedule);window.removeEventListener("hashchange",onHashChange);if(frame)cancelAnimationFrame(frame);frame=0};update()};const getSidebar=()=>document.getElementById("nd-sidebar");const ensureActiveVisible=()=>{const sidebar=getSidebar();if(!sidebar)return;const active=sidebar.querySelector('a[data-active="true"]');if(!(active instanceof HTMLElement))return;const activeRect=active.getBoundingClientRect();const sidebarRect=sidebar.getBoundingClientRect();if(activeRect.top<sidebarRect.top||activeRect.bottom>sidebarRect.bottom)sidebar.scrollTop+=activeRect.top-sidebarRect.top-(sidebar.clientHeight-activeRect.height)/2};const setSidebarActive=(path)=>{const sidebar=getSidebar();if(!sidebar)return;const current=normalizePath(path);for(const link of Array.from(sidebar.querySelectorAll("a[href]"))){try{link.dataset.active=normalizePath(new URL(link.href,location.href).pathname)===current?"true":"false"}catch{}}ensureActiveVisible()};const initMobileSidebar=()=>{const layout=document.getElementById("nd-docs-layout");const sidebar=getSidebar();const toggle=document.querySelector("[data-sidebar-toggle]");const backdrop=document.querySelector("[data-sidebar-backdrop]");if(!layout||!sidebar||!(toggle instanceof HTMLButtonElement))return;const setOpen=(open)=>{layout.dataset.sidebarOpen=open?"true":"false";sidebar.classList.toggle("fd-sidebar-open",open);document.documentElement.dataset.farmDocsSidebar=open?"open":"closed";toggle.setAttribute("aria-expanded",open?"true":"false");toggle.setAttribute("aria-label",open?"Close menu":"Open menu")};const toggleOpen=()=>setOpen(layout.dataset.sidebarOpen!=="true");closeMobileSidebar=()=>setOpen(false);toggle.addEventListener("click",(event)=>{event.preventDefault();toggleOpen()});backdrop?.addEventListener("click",()=>closeMobileSidebar());document.addEventListener("keydown",(event)=>{if(event.key==="Escape")closeMobileSidebar()});sidebar.addEventListener("click",(event)=>{const target=event.target instanceof Element?event.target.closest("a[href]"):null;if(target)closeMobileSidebar()});closeMobileSidebar()};const initSidebarScroll=()=>{const sidebar=getSidebar();if(!sidebar)return;const key="farmdocs:sidebar-scroll:"+location.origin;const getStorage=()=>{try{return window.sessionStorage}catch{return null}};const readSaved=()=>{try{const raw=getStorage()?.getItem(key);if(!raw)return null;const parsed=JSON.parse(raw);return parsed&&typeof parsed==="object"?parsed:null}catch{return null}};const save=(path=location.pathname)=>{try{getStorage()?.setItem(key,JSON.stringify({path,scrollTop:sidebar.scrollTop}))}catch{}};const saved=readSaved();if(saved?.path===location.pathname&&Number.isFinite(Number(saved.scrollTop)))sidebar.scrollTop=Number(saved.scrollTop);ensureActiveVisible();save();sidebar.addEventListener("scroll",()=>save(),{passive:true});sidebar.addEventListener("click",(event)=>{const target=event.target instanceof Element?event.target.closest("a[href]"):null;if(!target)return;try{save(new URL(target.href,location.href).pathname)}catch{save()}});window.addEventListener("beforeunload",()=>save())};let navigateController=null;const getPageKey=(root)=>{const article=root.getElementById("nd-page");if(!article)return"";return article.querySelector("h1")?.textContent?.trim()||article.textContent?.replace(/\\s+/g," ").trim().slice(0,160)||""};const swapDocsPage=(html,url)=>{const nextDoc=new DOMParser().parseFromString(html,"text/html");const nextArticle=nextDoc.getElementById("nd-page");const currentArticle=document.getElementById("nd-page");if(!nextArticle||!currentArticle)return false;const nextKey=getPageKey(nextDoc);const importedArticle=document.importNode(nextArticle,true);currentArticle.replaceWith(importedArticle);const renderedArticle=document.getElementById("nd-page");if(!renderedArticle||renderedArticle===currentArticle||(nextKey&&getPageKey(document)!==nextKey))return false;const nextToc=nextDoc.getElementById("nd-toc");const currentToc=document.getElementById("nd-toc");if(nextToc&&currentToc)currentToc.replaceWith(document.importNode(nextToc,true));reconcileDocsHead(nextDoc);setSidebarActive(url.pathname);initToc();closeMobileSidebar();return true};const navigateDocs=async(url,{replace=false,scroll=true}={})=>{if(!isDocsPath(url.pathname))return false;if(navigateController)navigateController.abort();const controller=new AbortController();navigateController=controller;document.documentElement.dataset.farmDocsNavigating="true";try{const response=await fetch(url.href,{cache:"no-store",headers:{accept:"text/html","x-farm-docs-navigate":"1"},signal:controller.signal});if(!response.ok||!((response.headers.get("content-type")||"").includes("text/html")))return false;const html=await response.text();if(!swapDocsPage(html,url))return false;if(replace)history.replaceState({farmDocs:true},"",url.href);else history.pushState({farmDocs:true},"",url.href);if(scroll){if(url.hash){let id=url.hash.slice(1);try{id=decodeURIComponent(id)}catch{}document.getElementById(id)?.scrollIntoView({block:"start"})}else window.scrollTo({top:0,left:0})}return true}catch(error){if(error?.name==="AbortError")return true;return false}finally{if(navigateController===controller){delete document.documentElement.dataset.farmDocsNavigating;navigateController=null}}};const initClientNavigation=()=>{document.addEventListener("click",(event)=>{if(event.defaultPrevented||event.button!==0||event.metaKey||event.ctrlKey||event.shiftKey||event.altKey)return;const target=event.target instanceof Element?event.target.closest("a[href]"):null;if(!target||target.target||target.hasAttribute("download"))return;let url;try{url=new URL(target.href,location.href)}catch{return}if(url.origin!==location.origin||!isDocsPath(url.pathname))return;if(normalizePath(url.pathname)===normalizePath(location.pathname)&&url.hash)return;event.preventDefault();navigateDocs(url).then((handled)=>{if(!handled)location.href=url.href})});window.addEventListener("popstate",()=>{navigateDocs(new URL(location.href),{replace:true,scroll:false}).then((handled)=>{if(!handled)location.reload()})})};const init=()=>{initToc();initMobileSidebar();initSidebarScroll();initClientNavigation()};if(document.readyState==="loading")document.addEventListener("DOMContentLoaded",init,{once:true});else init()})();</script>`;
+}
+function renderDocsPageActionsRuntimeScript() {
+  return `<script>(()=>{if(window.__farmDocsPageActionsRuntime)return;window.__farmDocsPageActionsRuntime=true;const readArticleText=()=>{const article=document.getElementById("nd-page");if(!article)return"";const clone=article.cloneNode(true);if(!(clone instanceof HTMLElement))return article.innerText||"";clone.querySelectorAll("[data-page-actions],.fd-page-footer,.fd-page-nav").forEach((node)=>node.remove());return clone.innerText||""};const withTitle=(content,format,includeTitle)=>{if(!includeTitle)return content;const title=document.querySelector("#nd-page h1")?.textContent?.trim()||document.title.trim();if(!title)return content;const trimmed=content.trimStart();if(trimmed.startsWith(title)||trimmed.startsWith("# "+title))return content;return format==="markdown"?"# "+title+"\\n\\n"+content:title+"\\n\\n"+content};const writeClipboard=async(text)=>{if(navigator.clipboard?.writeText){try{await navigator.clipboard.writeText(text);return}catch{}}const textarea=document.createElement("textarea");textarea.value=text;textarea.setAttribute("readonly","");textarea.style.position="fixed";textarea.style.opacity="0";textarea.style.pointerEvents="none";document.body.appendChild(textarea);textarea.select();document.execCommand("copy");textarea.remove()};const markCopied=(button)=>{const label=button.querySelector("[data-page-action-label]");button.dataset.copied="true";button.setAttribute("aria-label",button.dataset.copiedLabel||"Copied!");button.title=button.dataset.copiedLabel||"Copied!";if(label)label.textContent=button.dataset.copiedLabel||"Copied!";const previous=Number(button.dataset.copyTimeout||0);if(previous)clearTimeout(previous);button.dataset.copyTimeout=String(setTimeout(()=>{button.dataset.copied="false";button.setAttribute("aria-label",button.dataset.copyLabel||"Copy page");button.title=button.dataset.copyLabel||"Copy page";if(label)label.textContent=button.dataset.copyLabel||"Copy page";button.dataset.copyTimeout="0"},4500))};const markCodeCopied=(button)=>{button.dataset.copied="true";button.setAttribute("aria-label","Copied");button.title="Copied";const previous=Number(button.dataset.copyTimeout||0);if(previous)clearTimeout(previous);button.dataset.copyTimeout=String(setTimeout(()=>{button.dataset.copied="false";button.setAttribute("aria-label","Copy code");button.title="Copy code";button.dataset.copyTimeout="0"},4500))};document.addEventListener("click",async(event)=>{const source=event.target instanceof Element?event.target:null;const codeButton=source?.closest("[data-code-copy]");if(codeButton instanceof HTMLButtonElement){event.preventDefault();const code=codeButton.closest("figure")?.querySelector("code");if(!(code instanceof HTMLElement))return;const content=code.innerText||code.textContent||"";if(!content)return;await writeClipboard(content);markCodeCopied(codeButton);return}const target=source?.closest('[data-page-action="copy-markdown"]');if(!(target instanceof HTMLButtonElement))return;event.preventDefault();const format=target.dataset.copyMarkdownFormat==="text"?"text":"markdown";const includeTitle=target.dataset.copyMarkdownIncludeTitle==="true";let content="";target.disabled=true;try{if(format==="markdown"&&target.dataset.markdownUrl){try{const response=await fetch(target.dataset.markdownUrl,{headers:{Accept:"text/markdown"}});if(response.ok)content=await response.text()}catch{}}if(!content)content=readArticleText();content=withTitle(content,format,includeTitle);if(content.trim()){await writeClipboard(content);markCopied(target)}}finally{target.disabled=false}})})();</script>`;
+}
+function renderDocsHashRuntimeScript() {
+  return `<script>(()=>{if(window.__farmDocsHashRuntime)return;window.__farmDocsHashRuntime=true;const scrollToHash=()=>{if(!location.hash)return;let id=location.hash.slice(1);try{id=decodeURIComponent(id)}catch{}document.getElementById(id)?.scrollIntoView({block:"start"})};const schedule=()=>requestAnimationFrame(()=>requestAnimationFrame(scrollToHash));if(document.readyState==="loading")document.addEventListener("DOMContentLoaded",schedule,{once:true});else schedule();window.addEventListener("load",schedule,{once:true});window.addEventListener("hashchange",schedule)})();</script>`;
+}
+function renderDocsRuntimeScripts(docs) {
+  return stampFarmCspNonce(`${renderDocsRuntimeScript(docs)}
+${renderDocsHashRuntimeScript()}
+${renderDocsPageActionsRuntimeScript()}`);
+}
+function renderFarmDocsFontPreloads(fontAssets) {
+  return fontAssets.map(
+    ({ url }) => `<link rel="preload" href="${escapeAttribute(url)}" as="font" type="font/woff2" crossorigin>`
+  ).join("\n  ");
+}
+function renderFarmDocsFontPreloadHeader(fontAssets) {
+  return fontAssets.map(({ url }) => `<${url}>; rel=preload; as=font; type=font/woff2; crossorigin`).join(", ");
+}
+function getFarmLayoutFontPreloads(layoutFonts) {
+  const seen = /* @__PURE__ */ new Set();
+  return [layoutFonts?.body, layoutFonts?.code].flatMap(
+    (font) => (font?.preloads || []).filter(({ href }) => {
+      if (seen.has(href)) return false;
+      seen.add(href);
+      return true;
+    })
+  );
+}
+function renderFarmLayoutFontPreloadHeader(layoutFonts) {
+  return getFarmLayoutFontPreloads(layoutFonts).map(({ href, type }) => `<${href}>; rel=preload; as=font; type=${type}; crossorigin`).join(", ");
+}
+function renderPixelDocsHtml(page, pages, docs, clientEntry, faviconHref, requestUrl, fontAssets, fontStylesheetHref, globalStylesheetHref) {
+  const navTitle = typeof docs.config.nav === "object" && docs.config.nav && "title" in docs.config.nav ? String(docs.config.nav.title || "Docs") : "Docs";
+  const description = page.description || docs.config.metadata?.description || "";
+  const renderedMarkdown = renderMarkdownDocument(page.body, getThemeTocDepth(docs));
+  const tocItems = renderedMarkdown.tocItems;
+  const themeName = getThemeName(docs);
+  const searchEnabled = isFarmDocsSearchEnabled(docs);
+  const socialMetadata = isFarmDocsSocialImageEnabled(page, docs) ? renderFarmDocsSocialMetadata(
+    createFarmDocsSocialImageDescriptor(page, docs, requestUrl),
+    getFarmDocsCustomSocialImage(page)
+  ) : "";
+  return `<!DOCTYPE html>
+<html class="dark" lang="en" data-docs-theme="${escapeAttribute(themeName)}">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <meta name="generator" content="@farming-labs/docs via Farm.js">
+  <title>${escapeHtml(page.title)}</title>
+  ${renderFarmDocsFaviconLink(faviconHref)}
+  ${renderFarmDocsFontPreloads(fontAssets)}
+  ${fontStylesheetHref ? `<link rel="stylesheet" href="${escapeAttribute(fontStylesheetHref)}">` : ""}
+  ${globalStylesheetHref ? `<link rel="stylesheet" href="${escapeAttribute(globalStylesheetHref)}">` : ""}
+  ${description ? `<meta name="description" content="${escapeHtml(description)}">` : ""}
+  ${socialMetadata}
+  ${searchEnabled ? renderDocsSearchBootstrapScript() : ""}
+</head>
+<body>
+  <div id="nd-docs-layout" class="fd-layout" data-fd-framework="farmjs">
+    <header class="mobile-topbar fd-header" aria-label="Mobile docs navigation">
+      <button class="fd-mobile-nav-btn fd-menu-btn" type="button" data-sidebar-toggle aria-controls="nd-sidebar" aria-expanded="false" aria-label="Open menu">
+        <svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><line x1="3" y1="6" x2="21" y2="6"></line><line x1="3" y1="12" x2="21" y2="12"></line><line x1="3" y1="18" x2="21" y2="18"></line></svg>
+      </button>
+      <a class="fd-header-title" href="/">${escapeHtml(navTitle)}</a>
+      <div class="mobile-topbar-actions">
+        ${searchEnabled ? renderDocsSearchTrigger(true, "fd-search-trigger-mobile") : ""}
+        <a class="mobile-topbar-link" href="/llms.txt">llms.txt</a>
+      </div>
+    </header>
+    <aside id="nd-sidebar" class="fd-sidebar">
+      <div class="sidebar-brand fd-sidebar-header">
+        <a class="fd-sidebar-title" href="/">${renderFarmDocsBrandMark()}${renderFarmDocsBrandTitle(navTitle)}</a>
+        <span>/ docs</span>
+      </div>
+      ${searchEnabled ? `<div class="fd-sidebar-search">${renderDocsSearchTrigger(true, "fd-sidebar-search-btn")}</div>` : ""}
+      ${renderPixelNavItems(pages, page.href, docs)}
+    </aside>
+    <div class="sidebar-backdrop fd-sidebar-overlay" data-sidebar-backdrop></div>
+    <main class="fd-main">
+      <div class="fd-page">
+      <article id="nd-page" class="prose fd-page-article fd-page-body fd-docs-content">
+        ${renderPixelBreadcrumb(page, docs)}
+${renderMarkdownHtmlWithTitleMeta(page, docs, renderedMarkdown.html)}
+        ${renderPixelPageFooter(page, docs)}
+        ${renderPixelPageNav(pages, page.href, docs)}
+      </article>
+      <nav id="nd-toc" class="fd-toc sticky top-(--fd-docs-row-1) h-[calc(var(--fd-docs-height)-var(--fd-docs-row-1))] flex flex-col [grid-area:toc] w-(--fd-toc-width) pt-12 pe-4 pb-2 max-xl:hidden" data-toc aria-labelledby="toc-title">
+      <div class="fd-toc-inner">
+        <h3 id="toc-title" class="fd-toc-title inline-flex items-center gap-1.5 text-sm text-fd-muted-foreground"><svg class="size-4" viewBox="0 0 24 24" aria-hidden="true" focusable="false" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M4 7h16"></path><path d="M4 12h16"></path><path d="M4 17h16"></path></svg>On this page</h3>
+        <div class="toc-scroll">
+          ${renderPixelToc(tocItems)}
+        </div>
+      </div>
+    </nav>
+      </div>
+    </main>
+  </div>
+  ${searchEnabled ? renderDocsSearchMount(clientEntry) : ""}
+  ${renderDocsRuntimeScripts(docs)}
+</body>
+</html>`;
+}
+function createFarmDocsHandler(docs, options) {
+  const faviconHref = resolveFarmDocsFavicon(docs, options);
+  const fontAssets = options.fontAssets ?? toFarmDocsPublicFontAssets(resolveFarmDocsFontAssets(options.root));
+  const fallbackFontPreloadHeader = renderFarmDocsFontPreloadHeader(fontAssets);
+  return async function handleFarmDocsRequest(request) {
+    if (!docs?.enabled || request.method !== "GET" && request.method !== "HEAD") return null;
+    await loadFarmDocsEngine();
+    const contentDir = resolveFarmDocsContentDir(docs, options);
+    const requestUrl = new URL(request.url);
+    const socialImageSlug = getFarmDocsSocialImageSlug(docs, requestUrl);
+    if (socialImageSlug !== null) {
+      const socialImagePage = loadFarmDocsPage(contentDir, docs, socialImageSlug);
+      if (!socialImagePage || // The image sits outside the page's URL, where its guard does not reach, and
+      // draws the page's title.
+      options.isPathGuarded?.(socialImagePage.href) || !isFarmDocsSocialImageEnabled(socialImagePage, docs) || getFarmDocsCustomSocialImage(socialImagePage)) {
+        return null;
+      }
+      const descriptor = createFarmDocsSocialImageDescriptor(socialImagePage, docs, requestUrl);
+      if (requestUrl.pathname !== descriptor.imagePath) return null;
+      const etag = `"${descriptor.hash}"`;
+      const immutable = requestUrl.searchParams.get("v") === descriptor.hash;
+      const headers = new Headers({
+        "Content-Type": "image/svg+xml; charset=utf-8",
+        "Cache-Control": immutable ? "public, max-age=31536000, immutable" : "public, max-age=0, must-revalidate",
+        ETag: etag,
+        "X-Content-Type-Options": "nosniff"
+      });
+      if (matchesFarmIfNoneMatch(request.headers.get("if-none-match"), etag)) {
+        return new Response(null, { status: 304, headers });
+      }
+      if (request.method === "HEAD") return new Response(null, { status: 200, headers });
+      return new Response(renderFarmDocsSocialImageSvg(descriptor), { status: 200, headers });
+    }
+    const publicResponse = createFarmDocsPublicResponse(
+      contentDir,
+      docs,
+      request,
+      options.isPathGuarded
+    );
+    if (publicResponse) return omitFarmDocsHeadBody(request, publicResponse);
+    if (!isFarmDocsRequest(docs, request)) return null;
+    const page = loadPage(contentDir, docs, request);
+    if (!page) return null;
+    const negotiatesAccept = !requestUrl.pathname.endsWith(".md");
+    if (!negotiatesAccept && options.isPathGuarded?.(page.href) && !options.isPathGuarded(getFarmDocsMarkdownPath(page.href))) {
+      return null;
+    }
+    if (shouldReturnMarkdown(request)) {
+      const origin = new URL(request.url).origin;
+      return omitFarmDocsHeadBody(
+        request,
+        new Response(
+          docsEngine().renderDocsMarkdownDocument(toFarmDocsMarkdownPage(page), {
+            origin,
+            llms: docs.config.llmsTxt ?? true,
+            sitemap: docs.config.sitemap
+          }),
+          {
+            status: 200,
+            headers: {
+              "Content-Type": "text/markdown; charset=utf-8",
+              "Cache-Control": "public, max-age=60",
+              ...negotiatesAccept ? { Vary: "Accept" } : {}
+            }
+          }
+        )
+      );
+    }
+    const pathname = new URL(request.url).pathname;
+    const layoutFonts = await options.resolveLayoutFonts?.(pathname);
+    const usesLayoutFonts = Boolean(layoutFonts?.body || layoutFonts?.code);
+    const activeFontAssets = usesLayoutFonts ? [] : fontAssets;
+    const fontPreloadHeader = usesLayoutFonts ? renderFarmLayoutFontPreloadHeader(layoutFonts) : fallbackFontPreloadHeader;
+    return omitFarmDocsHeadBody(
+      request,
+      new Response(
+        renderPixelDocsHtml(
+          page,
+          discoverFarmDocsPages(contentDir, docs),
+          docs,
+          options.clientEntry || "/farm-client.js",
+          faviconHref,
+          requestUrl,
+          activeFontAssets,
+          usesLayoutFonts ? options.fontStylesheetHref : void 0,
+          options.globalStylesheetHref
+        ),
+        {
+          status: 200,
+          headers: {
+            "Content-Type": "text/html; charset=utf-8",
+            "Cache-Control": "public, s-maxage=60, stale-while-revalidate=300",
+            Vary: "Accept",
+            ...fontPreloadHeader ? { Link: fontPreloadHeader } : {}
+          }
+        }
+      )
+    );
+  };
+}
+
+export {
+  FARM_DOCS_LAST_MODIFIED_MANIFEST,
+  createFarmDocsLastModifiedManifest,
+  isFarmDocsRequest,
+  resolveFarmDocsContentDir,
+  getFarmDocsRouteTypeEntries,
+  getFarmDocsDocumentNavigationMatchers,
+  loadFarmDocsPage,
+  getFarmDocsMarkdownPath,
+  discoverFarmDocsPages,
+  toFarmDocsMarkdownPage,
+  createFarmDocsHandler
+};