@farm.js/core 0.1.34 → 0.1.36

package/dist/chunk-DTSROJ5J.mjs

@@ -0,0 +1,367 @@
+import {
+  getFarmMarkdownMirrorPath,
+  isFarmMarkdownMirrorExposed,
+  matchesFarmMarkdownRoutePattern
+} from "./chunk-WWIKMBRN.mjs";
+import {
+  FARM_INTERNAL_READ_HEADER
+} from "./chunk-MVL2RAJW.mjs";
+import {
+  applyFarmBasePath
+} from "./chunk-4RB44K6Z.mjs";
+import {
+  __name
+} from "./chunk-LPEX4YW6.mjs";
+
+// src/llms-txt.ts
+function resolveFarmLlmsTxtConfig(input) {
+  if (!input) return { enabled: false, include: [], exclude: [], full: false };
+  if (input === true) return { enabled: true, include: [], exclude: [], full: true };
+  if (typeof input !== "object") {
+    throw new TypeError("agent.llmsTxt must be true, false, or an options object.");
+  }
+  if (input.enabled === false) return { enabled: false, include: [], exclude: [], full: false };
+  for (const key of ["title", "summary", "details"]) {
+    if (input[key] !== void 0 && typeof input[key] !== "string") {
+      throw new TypeError(`agent.llmsTxt.${key} must be a string.`);
+    }
+  }
+  if (input.full !== void 0 && typeof input.full !== "boolean") {
+    throw new TypeError("agent.llmsTxt.full must be a boolean.");
+  }
+  if (input.revalidate !== void 0 && (typeof input.revalidate !== "number" || !Number.isFinite(input.revalidate) || input.revalidate < 0)) {
+    throw new TypeError("agent.llmsTxt.revalidate must be a number of seconds.");
+  }
+  return {
+    enabled: true,
+    ...input.title ? { title: input.title } : {},
+    ...input.summary ? { summary: input.summary } : {},
+    ...input.details ? { details: input.details } : {},
+    include: resolveRoutePatterns(input.include, "include"),
+    exclude: resolveRoutePatterns(input.exclude, "exclude"),
+    full: input.full !== false,
+    ...input.revalidate !== void 0 ? { revalidate: input.revalidate } : {}
+  };
+}
+__name(resolveFarmLlmsTxtConfig, "resolveFarmLlmsTxtConfig");
+function resolveRoutePatterns(value, key) {
+  if (value === void 0) return [];
+  if (!Array.isArray(value)) {
+    throw new TypeError(`agent.llmsTxt.${key} must be an array of route patterns.`);
+  }
+  return value.map((pattern, index) => {
+    if (typeof pattern !== "string" || !pattern.startsWith("/")) {
+      throw new TypeError(
+        `agent.llmsTxt.${key}[${index}] must be a route pattern starting with "/", such as "/docs/[...slug]".`
+      );
+    }
+    return pattern;
+  });
+}
+__name(resolveRoutePatterns, "resolveRoutePatterns");
+function collectFarmLlmsTxtPages(sources, options) {
+  const include = options.include ?? [];
+  const exclude = options.exclude ?? [];
+  const pages = /* @__PURE__ */ new Map();
+  for (const source of sources) {
+    const path = source.pattern;
+    if (path.includes("[") || pages.has(path)) continue;
+    if (include.length && !include.some((pattern) => matchesFarmMarkdownRoutePattern(pattern, path))) {
+      continue;
+    }
+    if (exclude.some((pattern) => matchesFarmMarkdownRoutePattern(pattern, path))) continue;
+    if (isFarmMetadataNoIndex(source.metadata)) continue;
+    const target = isFarmMarkdownMirrorExposed(options.markdown, path) ? getFarmMarkdownMirrorPath(path) : path;
+    const description = readMetadataString(source.metadata, "description");
+    pages.set(path, {
+      path,
+      title: readMetadataTitle(source.metadata) ?? fallbackPageTitle(path),
+      url: `${options.origin}${applyFarmBasePath(target, options.basePath)}`,
+      ...description ? { description } : {}
+    });
+  }
+  return [...pages.values()].sort((left, right) => left.path.localeCompare(right.path));
+}
+__name(collectFarmLlmsTxtPages, "collectFarmLlmsTxtPages");
+function isFarmMetadataNoIndex(metadata) {
+  if (!metadata || typeof metadata !== "object") return false;
+  const robots = metadata.robots;
+  if (typeof robots === "string") {
+    return robots.split(",").map((directive) => directive.trim().toLowerCase()).some((directive) => directive === "noindex" || directive === "none");
+  }
+  return Boolean(
+    robots && typeof robots === "object" && robots.index === false
+  );
+}
+__name(isFarmMetadataNoIndex, "isFarmMetadataNoIndex");
+function createFarmDefaultLlmsTxt(options) {
+  const { config, pages } = options;
+  const mcp = options.mcp ?? [];
+  const summary = config.summary ?? readMetadataString(options.rootMetadata, "description");
+  return {
+    title: config.title ?? readMetadataTitle(options.rootMetadata) ?? pages.find((page) => page.path === "/")?.title ?? new URL(options.origin).host,
+    ...summary ? { summary } : {},
+    ...config.details ? { details: config.details } : {},
+    sections: [
+      ...pages.length ? [
+        {
+          title: "Pages",
+          links: pages.map(({ title, url, description }) => ({
+            title,
+            url,
+            ...description ? { description } : {}
+          }))
+        }
+      ] : [],
+      ...mcp.length ? [{ title: "MCP", links: mcp }] : []
+    ]
+  };
+}
+__name(createFarmDefaultLlmsTxt, "createFarmDefaultLlmsTxt");
+function serializeFarmLlmsTxt(value) {
+  if (typeof value === "string") {
+    if (!value.trim()) throw new TypeError("llms.ts returned an empty llms.txt");
+    return value.endsWith("\n") ? value : `${value}
+`;
+  }
+  if (!isRecord(value)) {
+    throw new TypeError("llms.ts must return llms.txt text, an llms.txt object, or a Response");
+  }
+  const title = requireText(value.title, "llms.ts must return a non-empty title");
+  const summary = optionalText(value.summary, "llms.ts summary must be a string");
+  const details = optionalText(value.details, "llms.ts details must be a string");
+  if (value.sections !== void 0 && !Array.isArray(value.sections)) {
+    throw new TypeError("llms.ts sections must be an array");
+  }
+  const blocks = [`# ${toSingleLine(title)}`];
+  if (summary?.trim()) blocks.push(`> ${toSingleLine(summary)}`);
+  if (details?.trim()) blocks.push(details.trim());
+  for (const [sectionIndex, section] of (value.sections ?? []).entries()) {
+    if (!isRecord(section)) {
+      throw new TypeError(`llms.ts section ${sectionIndex} must be an object`);
+    }
+    const sectionTitle = requireText(
+      section.title,
+      `llms.ts section ${sectionIndex} must include a non-empty title`
+    );
+    if (!Array.isArray(section.links)) {
+      throw new TypeError(`llms.ts section "${sectionTitle}" must include a links array`);
+    }
+    const links = section.links.map((link, linkIndex) => {
+      const where = `llms.ts section "${sectionTitle}" link ${linkIndex}`;
+      if (!isRecord(link)) throw new TypeError(`${where} must be an object`);
+      const linkTitle = requireText(link.title, `${where} must include a non-empty title`);
+      const url = requireText(link.url, `${where} must include a non-empty url`);
+      const description = optionalText(link.description, `${where} description must be a string`);
+      return `- [${escapeLinkText(linkTitle)}](${escapeLinkUrl(url)})${description?.trim() ? `: ${toSingleLine(description)}` : ""}`;
+    });
+    blocks.push(`## ${toSingleLine(sectionTitle)}`, links.join("\n"));
+  }
+  return `${blocks.filter(Boolean).join("\n\n")}
+`;
+}
+__name(serializeFarmLlmsTxt, "serializeFarmLlmsTxt");
+function createFarmLlmsMarkdownReader(fetchMarkdown) {
+  return async (url) => {
+    try {
+      const response = await fetchMarkdown(
+        new Request(url, {
+          headers: { accept: "text/markdown", [FARM_INTERNAL_READ_HEADER]: "llms-full" }
+        })
+      );
+      const type = response.headers.get("content-type") ?? "";
+      if (!response.ok || !type.toLowerCase().startsWith("text/markdown")) {
+        await response.body?.cancel();
+        return null;
+      }
+      return await response.text();
+    } catch {
+      return null;
+    }
+  };
+}
+__name(createFarmLlmsMarkdownReader, "createFarmLlmsMarkdownReader");
+var FARM_LLMS_FULL_PAGE_TIMEOUT_MS = 3e4;
+var LLMS_PAGE_TIMED_OUT = /* @__PURE__ */ Symbol("farm.llms.pageTimedOut");
+async function renderFarmLlmsFullTxt(value, options) {
+  const index = serializeFarmLlmsTxt(value);
+  if (typeof value === "string") return index;
+  const llms = value;
+  const links = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const section of llms.sections ?? []) {
+    for (const link of section.links) {
+      if (seen.has(link.url)) continue;
+      seen.add(link.url);
+      links.push(link);
+    }
+  }
+  const pageTimeout = options.pageTimeout ?? FARM_LLMS_FULL_PAGE_TIMEOUT_MS;
+  const readWithinTimeout = /* @__PURE__ */ __name(async (url) => {
+    let timer;
+    const timedOut = new Promise((resolve) => {
+      timer = setTimeout(resolve, pageTimeout, LLMS_PAGE_TIMED_OUT);
+    });
+    try {
+      const content = await Promise.race([options.readMarkdown(url), timedOut]);
+      if (content !== LLMS_PAGE_TIMED_OUT) return content;
+      options.onIncomplete?.();
+      return null;
+    } finally {
+      clearTimeout(timer);
+    }
+  }, "readWithinTimeout");
+  const contents = await mapWithConcurrency(
+    links,
+    options.concurrency ?? 4,
+    (link) => shouldInlineLlmsLink(link.url, options.origin) ? readWithinTimeout(link.url) : null
+  );
+  const blocks = [`# ${toSingleLine(llms.title)}`];
+  if (llms.summary?.trim()) blocks.push(`> ${toSingleLine(llms.summary)}`);
+  if (llms.details?.trim()) blocks.push(llms.details.trim());
+  const pages = links.map((link, index2) => {
+    const parts = [`## ${toSingleLine(link.title)}`, `URL: ${escapeLinkUrl(link.url)}`];
+    if (link.description?.trim()) parts.push(toSingleLine(link.description));
+    const content = stripFrontmatter(contents[index2] ?? "").trim();
+    if (content) parts.push(content);
+    return parts.join("\n\n");
+  });
+  if (pages.length) blocks.push(pages.join("\n\n---\n\n"));
+  return `${blocks.join("\n\n")}
+`;
+}
+__name(renderFarmLlmsFullTxt, "renderFarmLlmsFullTxt");
+function createFarmLlmsFullRenderer(options = {}) {
+  const now = options.now ?? Date.now;
+  const ttl = (options.revalidate ?? 0) * 1e3;
+  const maxEntries = options.maxEntries ?? 16;
+  const entries = /* @__PURE__ */ new Map();
+  let queue = Promise.resolve();
+  const settle = /* @__PURE__ */ __name((body, complete, onSettled) => onSettled ? body.then((value) => (onSettled(complete()), value)) : body, "settle");
+  return (origin, render, onSettled) => {
+    const entry = entries.get(origin);
+    if (entry && entry.expires > now()) return settle(entry.body, entry.complete, onSettled);
+    entries.delete(origin);
+    let complete = true;
+    const body = queue.then(
+      () => render({
+        incomplete: /* @__PURE__ */ __name(() => {
+          complete = false;
+        }, "incomplete")
+      })
+    );
+    queue = body.catch(() => {
+    });
+    const pending = { body, expires: Number.POSITIVE_INFINITY, complete: /* @__PURE__ */ __name(() => complete, "complete") };
+    entries.set(origin, pending);
+    if (entries.size > maxEntries) entries.delete(entries.keys().next().value);
+    body.then(
+      () => {
+        if (entries.get(origin) !== pending) return;
+        if (ttl > 0 && complete) pending.expires = now() + ttl;
+        else entries.delete(origin);
+      },
+      () => {
+        if (entries.get(origin) === pending) entries.delete(origin);
+      }
+    );
+    return settle(body, pending.complete, onSettled);
+  };
+}
+__name(createFarmLlmsFullRenderer, "createFarmLlmsFullRenderer");
+function stripFrontmatter(markdown) {
+  const match = /^\uFEFF?---\r?\n[\s\S]*?\r?\n---[ \t]*(?:\r?\n|$)/.exec(markdown);
+  return match ? markdown.slice(match[0].length) : markdown;
+}
+__name(stripFrontmatter, "stripFrontmatter");
+function shouldInlineLlmsLink(url, origin) {
+  let target;
+  try {
+    target = new URL(url, origin);
+  } catch {
+    return false;
+  }
+  return target.origin === origin && !/\/llms(-full)?\.txt$/.test(target.pathname);
+}
+__name(shouldInlineLlmsLink, "shouldInlineLlmsLink");
+async function mapWithConcurrency(items, limit, run) {
+  const results = [];
+  let next = 0;
+  const worker = /* @__PURE__ */ __name(async () => {
+    while (next < items.length) {
+      const index = next++;
+      results[index] = await run(items[index]);
+    }
+  }, "worker");
+  await Promise.all(Array.from({ length: Math.min(Math.max(limit, 1), items.length) }, worker));
+  return results;
+}
+__name(mapWithConcurrency, "mapWithConcurrency");
+function readMetadataTitle(metadata) {
+  if (!isRecord(metadata)) return void 0;
+  const { title } = metadata;
+  if (typeof title === "string") return title.trim() || void 0;
+  if (isRecord(title)) {
+    for (const key of ["absolute", "default"]) {
+      const value = title[key];
+      if (typeof value === "string" && value.trim()) return value.trim();
+    }
+  }
+  return void 0;
+}
+__name(readMetadataTitle, "readMetadataTitle");
+function readMetadataString(metadata, key) {
+  if (!isRecord(metadata)) return void 0;
+  const value = metadata[key];
+  return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+__name(readMetadataString, "readMetadataString");
+function fallbackPageTitle(path) {
+  if (path === "/") return "Home";
+  const segments = path.split("/").filter(Boolean);
+  const segment = segments[segments.length - 1] ?? path;
+  const words = segment.replace(/[-_]+/g, " ").trim();
+  return words ? words[0].toUpperCase() + words.slice(1) : path;
+}
+__name(fallbackPageTitle, "fallbackPageTitle");
+function toSingleLine(value) {
+  return value.replace(/\s+/g, " ").trim();
+}
+__name(toSingleLine, "toSingleLine");
+function escapeLinkText(value) {
+  return toSingleLine(value).replace(/[\\[\]]/g, "\\$&");
+}
+__name(escapeLinkText, "escapeLinkText");
+function escapeLinkUrl(value) {
+  return value.trim().replace(
+    /[\s()<>]/g,
+    (character) => character === "(" ? "%28" : character === ")" ? "%29" : encodeURIComponent(character)
+  );
+}
+__name(escapeLinkUrl, "escapeLinkUrl");
+function requireText(value, message) {
+  if (typeof value !== "string" || !value.trim()) throw new TypeError(message);
+  return value;
+}
+__name(requireText, "requireText");
+function optionalText(value, message) {
+  if (value === void 0) return void 0;
+  if (typeof value !== "string") throw new TypeError(message);
+  return value;
+}
+__name(optionalText, "optionalText");
+function isRecord(value) {
+  return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+__name(isRecord, "isRecord");
+
+export {
+  resolveFarmLlmsTxtConfig,
+  collectFarmLlmsTxtPages,
+  isFarmMetadataNoIndex,
+  createFarmDefaultLlmsTxt,
+  serializeFarmLlmsTxt,
+  createFarmLlmsMarkdownReader,
+  renderFarmLlmsFullTxt,
+  createFarmLlmsFullRenderer
+};

package/dist/{chunk-ODBZYBAB.cjs → chunk-DZ5ZVB2K.cjs}

@@ -1,5 +1,5 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});// package.json
-var version = "0.1.34";
+var version = "0.1.36";
 
 // src/version.ts
 var FARM_VERSION = version;

package/dist/{chunk-ROUTX2E5.cjs → chunk-ECKF2BAM.cjs}

@@ -1,5 +1,9 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
+
+var _chunkWWFTAUFGcjs = require('./chunk-WWFTAUFG.cjs');
+
+
 var _chunkS3JO3N4Hcjs = require('./chunk-S3JO3N4H.cjs');
 
 // src/client/isolated-boundary.ts
@@ -63,6 +67,7 @@ function isolateFarmServerPageGraph(ReactRuntime, element) {
   return ReactRuntime.createElement(Context.Provider, { value: false }, element);
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, isolateFarmServerPageGraph, "isolateFarmServerPageGraph");
+var warnedUnserializableBoundaries = /* @__PURE__ */ new Set();
 function createFarmIsolatedClientBoundary(ReactRuntime, Component, moduleReference, exportName, islandStrategy) {
   function FarmIsolatedClientBoundary(props) {
     const Context = getBoundaryGraphContext(ReactRuntime);
@@ -75,9 +80,12 @@ function createFarmIsolatedClientBoundary(ReactRuntime, Component, moduleReferen
     try {
       serializedProps = serializeBoundaryPayload(props);
     } catch (error) {
-      if (typeof window === "undefined") {
+      const message = error instanceof Error ? error.message : String(error);
+      const warningKey = `${moduleReference}#${exportName}:${message}`;
+      if (typeof window === "undefined" && !warnedUnserializableBoundaries.has(warningKey)) {
+        warnedUnserializableBoundaries.add(warningKey);
         console.warn(
-          `[Farm.js] Could not isolate ${moduleReference}#${exportName}: ${error instanceof Error ? error.message : String(error)}. The server-rendered component was preserved without client hydration.`
+          `[Farm.js] Could not isolate ${moduleReference}#${exportName}: ${message}. The server-rendered component was preserved without client hydration.`
         );
       }
       return ReactRuntime.createElement(Component, props);
@@ -109,6 +117,11 @@ function createFarmIsolatedClientBoundary(ReactRuntime, Component, moduleReferen
   }
   _chunkS3JO3N4Hcjs.__name.call(void 0, FarmIsolatedClientBoundary, "FarmIsolatedClientBoundary");
   FarmIsolatedClientBoundary.displayName = `FarmIsolated(${Component.displayName || Component.name || exportName})`;
+  _chunkWWFTAUFGcjs.markFarmClientReference.call(void 0, FarmIsolatedClientBoundary, {
+    reference: moduleReference,
+    exportName,
+    Component
+  });
   return FarmIsolatedClientBoundary;
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, createFarmIsolatedClientBoundary, "createFarmIsolatedClientBoundary");
@@ -300,7 +313,7 @@ function createFarmIsolatedHydrationRuntime(options) {
   _chunkS3JO3N4Hcjs.__name.call(void 0, hydrate, "hydrate");
   function updateModule(reference, module) {
     const originals = module.__farm_client_boundary_originals__;
-    let updated = 0;
+    let updated = _chunkWWFTAUFGcjs.updateFarmServerTreeModule.call(void 0, reference, module);
     for (const [container, record] of roots) {
       if (record.reference !== reference) continue;
       const Component = _optionalChain([originals, 'optionalAccess', _15 => _15[record.exportName]]);
@@ -355,7 +368,7 @@ function createFarmIsolatedHydrationRuntime(options) {
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, createFarmIsolatedHydrationRuntime, "createFarmIsolatedHydrationRuntime");
 function createFarmServerPageBoundary(ReactRuntime, runtime) {
-  return /* @__PURE__ */ _chunkS3JO3N4Hcjs.__name.call(void 0, function FarmServerPage(props) {
+  return /* @__PURE__ */ _chunkS3JO3N4Hcjs.__name.call(void 0, function FarmServerPage({ as = "div", ...props }) {
     const ref = ReactRuntime.useRef(null);
     const html = props.dangerouslySetInnerHTML.__html;
     ReactRuntime.useLayoutEffect(() => {
@@ -376,7 +389,7 @@ function createFarmServerPageBoundary(ReactRuntime, runtime) {
         });
       };
     }, [html]);
-    return ReactRuntime.createElement("div", { ...props, ref });
+    return ReactRuntime.createElement(as, { ...props, ref });
   }, "FarmServerPage");
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, createFarmServerPageBoundary, "createFarmServerPageBoundary");

package/dist/{chunk-3LUF2PE2.cjs → chunk-EK4QAEFZ.cjs}

@@ -17,6 +17,7 @@ async function resolveFarmNotFoundMetadata(layoutModules, notFoundModule) {
     if (typeof layout.generateMetadata === "function") {
       metadata = mergeMetadata(metadata, await layout.generateMetadata({ params: {} }));
     }
+    metadata = await mergeModuleViewport(metadata, layout, { params: {} });
   }
   let own = {};
   let latestTitle;
@@ -28,6 +29,7 @@ async function resolveFarmNotFoundMetadata(layoutModules, notFoundModule) {
       own = mergeMetadata(own, generated);
       if (_optionalChain([generated, 'optionalAccess', _3 => _3.title]) !== void 0) latestTitle = generated.title;
     }
+    own = await mergeModuleViewport(own, notFoundModule, { params: {}, searchParams: {} });
   }
   const title = isRecord(latestTitle) && normalizeContent(latestTitle.absolute) ? latestTitle : own.title;
   return mergeMetadata(metadata, { ...own, title: _nullishCoalesce(title, () => ( FARM_NOT_FOUND_TITLE)) });
@@ -46,10 +48,67 @@ function mergeMetadata(base, next) {
     twitter: mergeNestedMetadata(base.twitter, next.twitter),
     alternates: mergeNestedMetadata(base.alternates, next.alternates),
     icons: mergeNestedMetadata(base.icons, next.icons),
-    verification: mergeNestedMetadata(base.verification, next.verification)
+    verification: mergeNestedMetadata(base.verification, next.verification),
+    viewport: mergeNestedMetadata(base.viewport, next.viewport)
   };
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, mergeMetadata, "mergeMetadata");
+async function mergeModuleViewport(metadata, module, props) {
+  let merged = metadata;
+  if (isRecord(_optionalChain([module, 'optionalAccess', _4 => _4.viewport]))) {
+    merged = mergeMetadata(merged, { viewport: module.viewport });
+  }
+  if (typeof _optionalChain([module, 'optionalAccess', _5 => _5.generateViewport]) === "function") {
+    const generated = await module.generateViewport(props);
+    if (isRecord(generated)) merged = mergeMetadata(merged, { viewport: generated });
+  }
+  return merged;
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, mergeModuleViewport, "mergeModuleViewport");
+var DEFAULT_VIEWPORT = { width: "device-width", initialScale: 1 };
+var VIEWPORT_CONTENT_KEYS = [
+  ["width", "width"],
+  ["height", "height"],
+  ["initialScale", "initial-scale"],
+  ["minimumScale", "minimum-scale"],
+  ["maximumScale", "maximum-scale"],
+  ["userScalable", "user-scalable"],
+  ["viewportFit", "viewport-fit"],
+  ["interactiveWidget", "interactive-widget"]
+];
+function renderViewportHead(viewport) {
+  const marker = ` ${FARM_METADATA_ATTRIBUTE}`;
+  if (typeof viewport === "string") {
+    return `<meta name="viewport" content="${escapeAttribute(viewport)}"${marker}>`;
+  }
+  const resolved = {
+    ...DEFAULT_VIEWPORT,
+    ...isRecord(viewport) ? viewport : {}
+  };
+  const content = VIEWPORT_CONTENT_KEYS.flatMap(([key, name]) => {
+    const value = resolved[key];
+    if (value === void 0 || value === null || value === "") return [];
+    if (typeof value === "boolean") return [`${name}=${value ? "yes" : "no"}`];
+    return [`${name}=${String(value)}`];
+  }).join(", ");
+  const tags = content ? [`<meta name="viewport" content="${escapeAttribute(content)}"${marker}>`] : [];
+  const themeColors = Array.isArray(resolved.themeColor) ? resolved.themeColor : resolved.themeColor === void 0 ? [] : [resolved.themeColor];
+  for (const entry of themeColors) {
+    const color = typeof entry === "string" ? entry : isRecord(entry) ? entry.color : void 0;
+    const content2 = normalizeContent(color);
+    if (!content2) continue;
+    const media = isRecord(entry) ? normalizeContent(entry.media) : void 0;
+    tags.push(
+      `<meta name="theme-color" content="${escapeAttribute(content2)}"${media ? ` media="${escapeAttribute(media)}"` : ""}${marker}>`
+    );
+  }
+  const colorScheme = normalizeContent(resolved.colorScheme);
+  if (colorScheme) {
+    tags.push(`<meta name="color-scheme" content="${escapeAttribute(colorScheme)}"${marker}>`);
+  }
+  return tags.join("\n  ");
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, renderViewportHead, "renderViewportHead");
 function mergeMetadataTitle(base, next) {
   if (next === void 0) return base;
   const parentTemplate = isRecord(base) ? normalizeContent(base.template) : void 0;
@@ -137,8 +196,8 @@ function renderMetadataHead(metadata, options = {}) {
   appendMetaName(tags, "author", resolvedMetadata.author);
   if (Array.isArray(resolvedMetadata.authors)) {
     for (const author of resolvedMetadata.authors) {
-      appendMetaName(tags, "author", _optionalChain([author, 'optionalAccess', _4 => _4.name]));
-      if (_optionalChain([author, 'optionalAccess', _5 => _5.url])) {
+      appendMetaName(tags, "author", _optionalChain([author, 'optionalAccess', _6 => _6.name]));
+      if (_optionalChain([author, 'optionalAccess', _7 => _7.url])) {
         appendLink(tags, "author", resolveMetadataUrl(author.url, metadataBase));
       }
     }
@@ -209,7 +268,8 @@ function renderMetadataHead(metadata, options = {}) {
     tags: tags.length > 0 ? `
   ${tags.join("\n  ")}` : "",
     hasFavicon,
-    hasExplicitTitle: Boolean(explicitTitle)
+    hasExplicitTitle: Boolean(explicitTitle),
+    viewport: renderViewportHead(resolvedMetadata.viewport)
   };
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, renderMetadataHead, "renderMetadataHead");
@@ -485,4 +545,6 @@ _chunkS3JO3N4Hcjs.__name.call(void 0, escapeAttribute, "escapeAttribute");
 
 
 
-exports.FARM_METADATA_ATTRIBUTE = FARM_METADATA_ATTRIBUTE; exports.resolveFarmNotFoundMetadata = resolveFarmNotFoundMetadata; exports.mergeMetadata = mergeMetadata; exports.addMetadataImageReference = addMetadataImageReference; exports.addMetadataMarkdownAlternate = addMetadataMarkdownAlternate; exports.renderMetadataHead = renderMetadataHead; exports.resolveMetadataTitle = resolveMetadataTitle;
+
+
+exports.FARM_METADATA_ATTRIBUTE = FARM_METADATA_ATTRIBUTE; exports.resolveFarmNotFoundMetadata = resolveFarmNotFoundMetadata; exports.mergeMetadata = mergeMetadata; exports.mergeModuleViewport = mergeModuleViewport; exports.renderViewportHead = renderViewportHead; exports.addMetadataImageReference = addMetadataImageReference; exports.addMetadataMarkdownAlternate = addMetadataMarkdownAlternate; exports.renderMetadataHead = renderMetadataHead; exports.resolveMetadataTitle = resolveMetadataTitle;

package/dist/{chunk-VVBO3QH7.mjs → chunk-ENLZ4R3Y.mjs}

@@ -40,7 +40,16 @@ async function hydrateFarmDocsAdapterRuntime() {
 }
 __name(generateFarmDocsAdapterClientRuntime, "generateFarmDocsAdapterClientRuntime");
 
+// src/docs/config-secrets.ts
+function isSecretDocsConfigKey(key) {
+  const normalized = key.replace(/[-_]/g, "").toLowerCase();
+  if (!normalized || normalized.endsWith("env")) return false;
+  return /apikey|token|secret|password|authorization|credential/.test(normalized);
+}
+__name(isSecretDocsConfigKey, "isSecretDocsConfigKey");
+
 export {
   getFarmDocsAdapterConfigModule,
-  generateFarmDocsAdapterClientRuntime
+  generateFarmDocsAdapterClientRuntime,
+  isSecretDocsConfigKey
 };

package/dist/{chunk-XXJU7FCC.cjs → chunk-EUV4YR3V.cjs}

@@ -3,7 +3,7 @@
 var _chunkJ63ZH5OQcjs = require('./chunk-J63ZH5OQ.cjs');
 
 
-var _chunkM64YUMA4cjs = require('./chunk-M64YUMA4.cjs');
+var _chunk75RZHGLScjs = require('./chunk-75RZHGLS.cjs');
 
 
 var _chunkFJ3M4CUXcjs = require('./chunk-FJ3M4CUX.cjs');
@@ -442,7 +442,7 @@ async function createMarkdownMirrorResponse(options) {
   for (const form of actions) {
     if (!_optionalChain([form, 'access', _16 => _16.action, 'optionalAccess', _17 => _17.startsWith, 'call', _18 => _18("/")])) continue;
     const pathname = new URL(form.action, pageUrl.origin).pathname;
-    const tool = _nullishCoalesce(_chunkM64YUMA4cjs._findFarmMCPEndpointTool.call(void 0, form.method, pathname, options.apiServerBasePath), () => ( _chunkM64YUMA4cjs._findFarmMCPEndpointTool.call(void 0, form.method, _chunkI57LW5VZcjs.stripFarmBasePath.call(void 0, pathname), options.apiServerBasePath)));
+    const tool = _nullishCoalesce(_chunk75RZHGLScjs._findFarmMCPEndpointTool.call(void 0, form.method, pathname, options.apiServerBasePath), () => ( _chunk75RZHGLScjs._findFarmMCPEndpointTool.call(void 0, form.method, _chunkI57LW5VZcjs.stripFarmBasePath.call(void 0, pathname), options.apiServerBasePath)));
     if (tool) form.tool = tool;
   }
   const markdown = pageResponse.status < 400 && requestUrl.searchParams.has("actions") ? "" : convertHtmlToMarkdown(

package/dist/{chunk-HR5KPHC2.mjs → chunk-EWET4D2Y.mjs}

@@ -4,7 +4,7 @@ import {
   getServerActionSignal,
   isServerFnFailure,
   runWithServerActionRequest
-} from "./chunk-QCFFHV5H.mjs";
+} from "./chunk-4WVJLURN.mjs";
 import {
   applyFarmCacheInvalidationTargets
 } from "./chunk-MSSFIQGM.mjs";

package/dist/{chunk-PXKIEXZD.mjs → chunk-F5QO4FNE.mjs}

@@ -1,6 +1,6 @@
 import {
   matchesFarmIfNoneMatch
-} from "./chunk-XF7Q24PF.mjs";
+} from "./chunk-ZMMBIVQM.mjs";
 import {
   __name
 } from "./chunk-LPEX4YW6.mjs";