@farm.js/core 0.1.0-beta.11 → 0.1.0-beta.14

package/dist/{chunk-4LND3PXF.mjs → chunk-OPHK6OJN.mjs}

@@ -4,7 +4,11 @@ import {
 } from "./chunk-V7RBCSDJ.mjs";
 import {
   resolveDocsConfig
-} from "./chunk-K5ZTUF22.mjs";
+} from "./chunk-L2PE36GQ.mjs";
+import {
+  resolveFarmDocsFontAssets,
+  toFarmDocsPublicFontAssets
+} from "./chunk-USLFXFFH.mjs";
 import {
   __name
 } from "./chunk-CGILA3WO.mjs";
@@ -224,8 +228,8 @@ var farmDocsPixelBorderCss = String.raw`
   --scrollbar-thumb-hover: var(--color-fd-ring);
   --scrollbar-track: transparent;
   --radius: 0px;
-  --font-geist-sans: "Geist Sans";
-  --font-geist-mono: "Geist Mono";
+  --font-geist-sans: ui-sans-serif, system-ui, sans-serif;
+  --font-geist-mono: ui-monospace, monospace;
 }
 
 .dark {
@@ -238,28 +242,6 @@ body,
   background-color: var(--color-fd-background) !important;
 }
 
-@font-face {
-  font-family: "Geist Sans";
-  font-display: block;
-  font-style: normal;
-  font-weight: 100 900;
-  src:
-    local("Geist Sans"),
-    url("/assets/Geist-Variable-CrgPqtmy.woff2") format("woff2"),
-    url("/node_modules/geist/dist/fonts/geist-sans/Geist-Variable.woff2") format("woff2");
-}
-
-@font-face {
-  font-family: "Geist Mono";
-  font-display: block;
-  font-style: normal;
-  font-weight: 100 900;
-  src:
-    local("Geist Mono"),
-    url("/assets/GeistMono-Variable-BNLlm6Cd.woff2") format("woff2"),
-    url("/node_modules/geist/dist/fonts/geist-mono/GeistMono-Variable.woff2") format("woff2");
-}
-
 * {
   scrollbar-color: var(--scrollbar-thumb) var(--scrollbar-track);
   scrollbar-width: thin;
@@ -1448,22 +1430,421 @@ code:not(pre code) {
 }
 `;
 
+// 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, "")}`;
+}
+__name(normalizeEntry, "normalizeEntry");
+function encodeSlugPath(slug) {
+  return slug.split("/").filter(Boolean).map((segment) => encodeURIComponent(segment)).join("/");
+}
+__name(encodeSlugPath, "encodeSlugPath");
+function getSocialImageConfig(docs) {
+  return typeof docs.config.socialImage === "object" && docs.config.socialImage ? docs.config.socialImage : void 0;
+}
+__name(getSocialImageConfig, "getSocialImageConfig");
+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");
+}
+__name(getNavTitle, "getNavTitle");
+function isFalse(value) {
+  return value ? /^(false|no|none|off|disabled)$/i.test(value.trim()) : false;
+}
+__name(isFalse, "isFalse");
+function isExternalOrRootPath(value) {
+  return /^(https?:)?\/\//i.test(value) || value.startsWith("/");
+}
+__name(isExternalOrRootPath, "isExternalOrRootPath");
+function isFarmDocsSocialImageEnabled(page, docs) {
+  if (docs.config.socialImage === false || getSocialImageConfig(docs)?.enabled === false) {
+    return false;
+  }
+  return !isFalse(page.frontmatter.socialImage);
+}
+__name(isFarmDocsSocialImageEnabled, "isFarmDocsSocialImageEnabled");
+function getFarmDocsCustomSocialImage(page) {
+  const value = page.frontmatter.socialImage || page.frontmatter.openGraphImage || page.frontmatter.ogImage;
+  return value && !isFalse(value) && isExternalOrRootPath(value) ? value : void 0;
+}
+__name(getFarmDocsCustomSocialImage, "getFarmDocsCustomSocialImage");
+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";
+}
+__name(resolveIllustration, "resolveIllustration");
+function createHashValue(value) {
+  return createHash("sha256").update(JSON.stringify(value)).digest("hex").slice(0, 16);
+}
+__name(createHashValue, "createHashValue");
+function resolveBaseUrl(requestUrl, config) {
+  return config?.baseUrl ? new URL(config.baseUrl) : new URL(requestUrl.origin);
+}
+__name(resolveBaseUrl, "resolveBaseUrl");
+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
+  };
+}
+__name(createFarmDocsSocialImageDescriptor, "createFarmDocsSocialImageDescriptor");
+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;
+  }
+}
+__name(getFarmDocsSocialImageSlug, "getFarmDocsSocialImageSlug");
+function escapeXml(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+__name(escapeXml, "escapeXml");
+function truncate(value, length) {
+  if (value.length <= length) return value;
+  return `${value.slice(0, Math.max(0, length - 1)).trimEnd()}\u2026`;
+}
+__name(truncate, "truncate");
+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;
+}
+__name(wrapText, "wrapText");
+function renderTextLines(lines, x, y, lineHeight, attributes) {
+  return lines.map(
+    (line, index) => `<text x="${x}" y="${y + index * lineHeight}" ${attributes}>${escapeXml(line)}</text>`
+  ).join("");
+}
+__name(renderTextLines, "renderTextLines");
+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;}`;
+}
+__name(renderEmbeddedFont, "renderEmbeddedFont");
+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}"/>`;
+}
+__name(renderArrow, "renderArrow");
+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>`;
+}
+__name(renderPanelHeader, "renderPanelHeader");
+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>`;
+}
+__name(renderRoutingIllustration, "renderRoutingIllustration");
+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>`;
+}
+__name(renderAuthIllustration, "renderAuthIllustration");
+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>`;
+}
+__name(renderCacheIllustration, "renderCacheIllustration");
+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>`;
+}
+__name(renderIntegrationsIllustration, "renderIntegrationsIllustration");
+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>`;
+}
+__name(renderCliIllustration, "renderCliIllustration");
+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>`;
+}
+__name(renderProjectIllustration, "renderProjectIllustration");
+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>`;
+}
+__name(renderRuntimeIllustration, "renderRuntimeIllustration");
+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();
+  }
+}
+__name(renderIllustration, "renderIllustration");
+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>`;
+}
+__name(renderFarmDocsSocialImageSvg, "renderFarmDocsSocialImageSvg");
+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 = /* @__PURE__ */ __name((property, content, name = false) => `<meta ${name ? "name" : "property"}="${property}" content="${escapeXml(content)}">`, "tag");
+  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  ");
+}
+__name(renderFarmDocsSocialMetadata, "renderFarmDocsSocialMetadata");
+
 // 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"];
-var GEIST_SANS_FONT_URL = "/assets/Geist-Variable-CrgPqtmy.woff2";
-var GEIST_MONO_FONT_URL = "/assets/GeistMono-Variable-BNLlm6Cd.woff2";
 function trimSlashes(value) {
   return value.replace(/^\/+|\/+$/g, "");
 }
 __name(trimSlashes, "trimSlashes");
-function normalizeEntry(entry) {
+function normalizeEntry2(entry) {
   if (!entry || entry === "/") return "/";
   return `/${trimSlashes(entry)}`;
 }
-__name(normalizeEntry, "normalizeEntry");
+__name(normalizeEntry2, "normalizeEntry");
 function normalizeSlug(value) {
   return trimSlashes(decodeURIComponent(value)).replace(/\.(mdx?|markdown)$/i, "");
 }
@@ -1528,7 +1909,7 @@ 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 = normalizeEntry(docs.entry);
+  const entry = normalizeEntry2(docs.entry);
   if (entry === "/") return true;
   return pathname === entry || pathname === `${entry}.md` || pathname.startsWith(`${entry}/`);
 }
@@ -1548,20 +1929,20 @@ function resolveFarmDocsContentDir(docs, options) {
 __name(resolveFarmDocsContentDir, "resolveFarmDocsContentDir");
 function getFarmDocsRouteTypeEntries(docs) {
   if (!docs?.enabled) return [];
-  const entry = normalizeEntry(docs.entry);
+  const entry = normalizeEntry2(docs.entry);
   if (entry === "/") return ["/", "/[...docs]"];
   return [entry, `${entry}/[...docs]`];
 }
 __name(getFarmDocsRouteTypeEntries, "getFarmDocsRouteTypeEntries");
 function getFarmDocsDocumentNavigationMatchers(docs) {
   if (!docs?.enabled) return [];
-  const entry = normalizeEntry(docs.entry);
+  const entry = normalizeEntry2(docs.entry);
   return [entry === "/" ? "/(.*)" : `${entry}(.*)`];
 }
 __name(getFarmDocsDocumentNavigationMatchers, "getFarmDocsDocumentNavigationMatchers");
 function getRequestSlug(docs, request) {
   const pathname = new URL(request.url).pathname;
-  const entry = normalizeEntry(docs.entry);
+  const entry = normalizeEntry2(docs.entry);
   if (entry === "/") return normalizeSlug(pathname);
   if (pathname === entry || pathname === `${entry}.md`) return "";
   return normalizeSlug(pathname.slice(entry.length));
@@ -1624,6 +2005,7 @@ function loadFarmDocsPage(contentDir, docs, slug) {
     slug,
     title,
     description: frontmatter.description,
+    section: frontmatter.section,
     href,
     sourcePath,
     lastModified: resolveFarmDocsPageLastModified(contentDir, sourcePath, frontmatter),
@@ -1633,7 +2015,7 @@ function loadFarmDocsPage(contentDir, docs, slug) {
 }
 __name(loadFarmDocsPage, "loadFarmDocsPage");
 function createDocsHref(entry, slug) {
-  const normalizedEntry = normalizeEntry(entry);
+  const normalizedEntry = normalizeEntry2(entry);
   const normalizedSlug = trimSlashes(slug);
   if (normalizedEntry === "/") return normalizedSlug ? `/${normalizedSlug}` : "/";
   return normalizedSlug ? `${normalizedEntry}/${normalizedSlug}` : normalizedEntry;
@@ -2604,7 +2986,7 @@ function renderPixelBreadcrumb(page, docs) {
   const parentSegments = segments.slice(0, -1);
   const parentSegment = parentSegments[parentSegments.length - 1];
   const currentSegment = segments[segments.length - 1];
-  const entry = normalizeEntry(docs.entry);
+  const entry = normalizeEntry2(docs.entry);
   const parentPath = parentSegments.join("/");
   const parentHref = entry === "/" ? `/${parentPath}` : `${entry}/${parentPath}`;
   return `<nav class="fd-breadcrumb" aria-label="Breadcrumb">
@@ -2647,7 +3029,7 @@ ${items.map(
 }
 __name(renderPixelToc, "renderPixelToc");
 function renderDocsRuntimeScript(docs) {
-  const docsEntry = JSON.stringify(normalizeEntry(docs.entry));
+  const docsEntry = JSON.stringify(normalizeEntry2(docs.entry));
   return `<script>(()=>{if(window.__farmDocsRuntime)return;window.__farmDocsRuntime=true;document.documentElement.dataset.farmDocsRuntime="true";document.documentElement.dataset.farmDocsRuntimeId=Math.random().toString(36).slice(2);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)link.dataset.active=link===active.link?"true":"false";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";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));if(nextDoc.title)document.title=nextDoc.title;const nextDescription=nextDoc.querySelector('meta[name="description"]');const currentDescription=document.querySelector('meta[name="description"]');if(nextDescription&&currentDescription)currentDescription.setAttribute("content",nextDescription.getAttribute("content")||"");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>`;
 }
 __name(renderDocsRuntimeScript, "renderDocsRuntimeScript");
@@ -2700,17 +3082,28 @@ ${readCssWithImports(themeCssPath)}`;
   }
 }
 __name(resolvePixelBorderThemeCss, "resolvePixelBorderThemeCss");
-function renderFarmDocsBridgeCss(docs) {
+function renderFarmDocsBridgeCss(docs, fontAssets, layoutFonts) {
   const sidebarWidth = getThemeLayoutValue(docs, "sidebarWidth", 320);
   const contentWidth = getThemeLayoutValue(docs, "contentWidth", 860);
+  const fontFaces = fontAssets.map(
+    ({ family, url }) => `@font-face { font-family: "${family}"; src: url("${url}") format("woff2"); font-style: normal; font-weight: 100 900; font-display: block; }`
+  ).join("\n");
+  const fontVariables = [
+    fontAssets.some(({ family }) => family === "Geist Sans") ? '--font-geist-sans: "Geist Sans", ui-sans-serif, system-ui, sans-serif;' : "",
+    fontAssets.some(({ family }) => family === "Geist Mono") ? '--font-geist-mono: "Geist Mono", ui-monospace, monospace;' : ""
+  ].filter(Boolean).join(" ");
+  const fontCss = fontFaces ? `${fontFaces}
+:root { ${fontVariables} }` : "";
+  const layoutFontVariables = [
+    renderFarmDocsLayoutFontVariable("--fd-layout-font-body", layoutFonts?.body),
+    renderFarmDocsLayoutFontVariable("--fd-layout-font-code", layoutFonts?.code)
+  ].filter(Boolean).join(" ");
   return `
-    @font-face { font-family: "Geist Sans"; src: local("Geist Sans"), url("${GEIST_SANS_FONT_URL}") format("woff2"), url("/node_modules/geist/dist/fonts/geist-sans/Geist-Variable.woff2") format("woff2"); font-display: block; font-style: normal; font-weight: 100 900; }
-    @font-face { font-family: "Geist Mono"; src: local("Geist Mono"), url("${GEIST_MONO_FONT_URL}") format("woff2"), url("/node_modules/geist/dist/fonts/geist-mono/GeistMono-Variable.woff2") format("woff2"); font-display: block; font-style: normal; font-weight: 100 900; }
-    :root { color-scheme: dark; --font-geist-sans: "Geist Sans"; --font-geist-mono: "Geist Mono"; --fd-sidebar-width: ${sidebarWidth}px; --fd-content-width: ${contentWidth}px; --fd-toc-width: 240px; --fd-docs-height: 100vh; --fd-docs-row-1: var(--fd-nav-height, 44px); --fd-docs-font-sans: var(--font-geist-sans, "Geist Sans", var(--font-sans, system-ui, -apple-system, sans-serif)); --fd-docs-font-mono: var(--font-geist-mono, "Geist Mono", var(--font-mono, ui-monospace, monospace)); --fd-font-sans: var(--fd-docs-font-sans); --fd-font-mono: var(--fd-docs-font-mono); --fd-pixel-rail-width: 12px; --fd-sidebar-edge: calc(var(--fd-pixel-rail-width) + 18px); --fd-sidebar-guide-x: calc(var(--fd-sidebar-edge) + 16px); --fd-sidebar-link-x: calc(var(--fd-sidebar-guide-x) + 22px); --fd-sidebar-sub-guide-x: calc(var(--fd-sidebar-link-x) + 7px); --fd-sidebar-sub-link-x: calc(var(--fd-sidebar-sub-guide-x) + 28px); --fd-sidebar-branch-gap: 0px; --fd-sidebar-nested-icon-gap: 0px; --fd-sidebar-line-color: color-mix(in srgb, var(--color-fd-border, hsl(0 0% 15%)) 88%, transparent); }
+    :root { color-scheme: dark; --font-geist-sans: ui-sans-serif, system-ui, sans-serif; --font-geist-mono: ui-monospace, monospace; ${layoutFontVariables} --fd-sidebar-width: ${sidebarWidth}px; --fd-content-width: ${contentWidth}px; --fd-toc-width: 240px; --fd-docs-height: 100vh; --fd-docs-row-1: var(--fd-nav-height, 44px); --fd-docs-font-sans: var(--fd-layout-font-body, var(--font-geist-sans, var(--font-sans, system-ui, -apple-system, sans-serif))); --fd-docs-font-mono: var(--fd-layout-font-code, var(--font-geist-mono, var(--font-mono, ui-monospace, monospace))); --fd-font-sans: var(--fd-docs-font-sans); --fd-font-mono: var(--fd-docs-font-mono); --fd-pixel-rail-width: 12px; --fd-sidebar-edge: calc(var(--fd-pixel-rail-width) + 18px); --fd-sidebar-guide-x: calc(var(--fd-sidebar-edge) + 16px); --fd-sidebar-link-x: calc(var(--fd-sidebar-guide-x) + 22px); --fd-sidebar-sub-guide-x: calc(var(--fd-sidebar-link-x) + 7px); --fd-sidebar-sub-link-x: calc(var(--fd-sidebar-sub-guide-x) + 28px); --fd-sidebar-branch-gap: 0px; --fd-sidebar-nested-icon-gap: 0px; --fd-sidebar-line-color: color-mix(in srgb, var(--color-fd-border, hsl(0 0% 15%)) 88%, transparent); }
     * { box-sizing: border-box; }
     html { background: var(--color-fd-background, hsl(0 0% 2%)); scroll-padding-top: calc(var(--fd-nav-height, 44px) + 24px); }
     html[data-farm-docs-sidebar="open"], html[data-farm-docs-sidebar="open"] body { overflow: hidden; }
-    body { margin: 0; min-height: 100vh; background: var(--color-fd-background, hsl(0 0% 2%)); color: var(--color-fd-foreground, oklch(0.985 0.001 106.423)); font-family: var(--fd-docs-font-sans); text-rendering: optimizeLegibility; }
+    body { margin: 0; min-height: 100vh; background: var(--color-fd-background, hsl(0 0% 2%)); color: var(--color-fd-foreground, oklch(0.985 0.001 106.423)); font-family: var(--fd-docs-font-sans); font-synthesis: none; text-rendering: optimizeLegibility; }
     ::selection { background: var(--color-fd-foreground, #fff); color: var(--color-fd-background, #000); }
     a { color: inherit; }
     #nd-docs-layout { --fd-sidebar-col: var(--fd-sidebar-width); display: grid; grid-template: "sidebar header header" var(--fd-nav-height, 44px) "sidebar main toc" 1fr / var(--fd-sidebar-width) minmax(0, 1fr) var(--fd-toc-width) !important; min-height: 100vh; border-top: 1px solid var(--color-fd-border, hsl(0 0% 15%)); background: var(--color-fd-background, hsl(0 0% 2%)); }
@@ -2890,15 +3283,51 @@ function renderFarmDocsBridgeCss(docs) {
       .sh__line { min-height: 1.6em; }
     }
 ${farmDocsPixelBorderCss}
+${fontCss}
   `;
 }
 __name(renderFarmDocsBridgeCss, "renderFarmDocsBridgeCss");
-function renderPixelDocsHtml(page, pages, docs, themeCss, clientEntry, faviconHref) {
+function renderFarmDocsLayoutFontVariable(name, font) {
+  const family = font?.style.fontFamily;
+  if (!family || /[;{}<>]/.test(family)) return "";
+  return `${name}: ${family};`;
+}
+__name(renderFarmDocsLayoutFontVariable, "renderFarmDocsLayoutFontVariable");
+function renderFarmDocsFontPreloads(fontAssets) {
+  return fontAssets.map(
+    ({ url }) => `<link rel="preload" href="${escapeAttribute(url)}" as="font" type="font/woff2" crossorigin>`
+  ).join("\n  ");
+}
+__name(renderFarmDocsFontPreloads, "renderFarmDocsFontPreloads");
+function renderFarmDocsFontPreloadHeader(fontAssets) {
+  return fontAssets.map(({ url }) => `<${url}>; rel=preload; as=font; type=font/woff2; crossorigin`).join(", ");
+}
+__name(renderFarmDocsFontPreloadHeader, "renderFarmDocsFontPreloadHeader");
+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;
+    })
+  );
+}
+__name(getFarmLayoutFontPreloads, "getFarmLayoutFontPreloads");
+function renderFarmLayoutFontPreloadHeader(layoutFonts) {
+  return getFarmLayoutFontPreloads(layoutFonts).map(({ href, type }) => `<${href}>; rel=preload; as=font; type=${type}; crossorigin`).join(", ");
+}
+__name(renderFarmLayoutFontPreloadHeader, "renderFarmLayoutFontPreloadHeader");
+function renderPixelDocsHtml(page, pages, docs, themeCss, clientEntry, faviconHref, requestUrl, fontAssets, layoutFonts, fontStylesheetHref) {
   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 tocItems = extractTocItems(page.body, getThemeTocDepth(docs));
   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>
@@ -2907,11 +3336,12 @@ function renderPixelDocsHtml(page, pages, docs, themeCss, clientEntry, faviconHr
   <meta name="generator" content="@farming-labs/docs via Farm.js">
   <title>${escapeHtml(page.title)}</title>
   ${renderFarmDocsFaviconLink(faviconHref)}
-  <link rel="preload" href="${GEIST_SANS_FONT_URL}" as="font" type="font/woff2" crossorigin>
-  <link rel="preload" href="${GEIST_MONO_FONT_URL}" as="font" type="font/woff2" crossorigin>
+  ${renderFarmDocsFontPreloads(fontAssets)}
+  ${fontStylesheetHref ? `<link rel="stylesheet" href="${escapeAttribute(fontStylesheetHref)}">` : ""}
   ${description ? `<meta name="description" content="${escapeHtml(description)}">` : ""}
+  ${socialMetadata}
   <style>${themeCss}
-${renderFarmDocsBridgeCss(docs)}</style>
+${renderFarmDocsBridgeCss(docs, fontAssets, layoutFonts)}</style>
   ${searchEnabled ? renderDocsSearchBootstrapScript() : ""}
 </head>
 <body>
@@ -2964,9 +3394,34 @@ ${renderMarkdownHtmlWithTitleMeta(page, docs)}
 __name(renderPixelDocsHtml, "renderPixelDocsHtml");
 function createFarmDocsHandler(docs, options) {
   const faviconHref = resolveFarmDocsFavicon(docs, options);
+  const fontAssets = options.fontAssets ?? toFarmDocsPublicFontAssets(resolveFarmDocsFontAssets(options.root));
+  const fallbackFontPreloadHeader = renderFarmDocsFontPreloadHeader(fontAssets);
   return /* @__PURE__ */ __name(async function handleFarmDocsRequest(request) {
     if (!docs?.enabled || request.method !== "GET" && request.method !== "HEAD") return null;
     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 || !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 (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);
     if (publicResponse) return publicResponse;
     if (!isFarmDocsRequest(docs, request)) return null;
@@ -2989,6 +3444,11 @@ function createFarmDocsHandler(docs, options) {
         }
       );
     }
+    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 new Response(
       renderPixelDocsHtml(
         page,
@@ -2996,13 +3456,18 @@ function createFarmDocsHandler(docs, options) {
         docs,
         resolvePixelBorderThemeCss(options),
         options.clientEntry || "/farm-client.js",
-        faviconHref
+        faviconHref,
+        requestUrl,
+        activeFontAssets,
+        layoutFonts,
+        usesLayoutFonts ? options.fontStylesheetHref : void 0
       ),
       {
         status: 200,
         headers: {
           "Content-Type": "text/html; charset=utf-8",
-          "Cache-Control": "public, s-maxage=60, stale-while-revalidate=300"
+          "Cache-Control": "public, s-maxage=60, stale-while-revalidate=300",
+          ...fontPreloadHeader ? { Link: fontPreloadHeader } : {}
         }
       }
     );
@@ -3537,4 +4002,4 @@ export {
   createDocsAPI,
   createFarmDocsAPIHandler
 };
-//# sourceMappingURL=chunk-4LND3PXF.mjs.map
+//# sourceMappingURL=chunk-OPHK6OJN.mjs.map