@farming-labs/docs 0.2.117 → 0.2.119

package/dist/sidebar-CFHBj29f.mjs

@@ -0,0 +1,421 @@
+import { $ as isDocsSkillRequest, K as isDocsAgentDiscoveryRequest, St as resolveDocsSkillFormat, Xt as resolveDocsContentChangesConfig, Yt as isDocsContentChangesRequest, dt as resolveDocsAgentFeedbackRequest, ft as resolveDocsAgentsFormat, mt as resolveDocsLlmsTxtRequest, q as isDocsAgentsRequest, ut as resolveDocsAgentFeedbackConfig, vt as resolveDocsMarkdownRequest } from "./agent-DkAidqtV.mjs";
+
+//#region src/telemetry.ts
+const DOCS_PACKAGE_NAME = "@farming-labs/docs";
+const DOCS_PACKAGE_VERSION = "0.2.25";
+const DEFAULT_DOCS_TELEMETRY_ENDPOINT = "https://docs.farming-labs.dev/api/telemetry/events";
+const PROJECT_TELEMETRY_CACHE_TTL_MS = 1440 * 60 * 1e3;
+const PROJECT_TELEMETRY_CACHE_MAX_KEYS = 256;
+function getRuntimeEnv() {
+	if (typeof process === "undefined" || !process.env) return;
+	return process.env;
+}
+function readRuntimeEnv(name) {
+	const value = getRuntimeEnv()?.[name]?.trim();
+	return value ? value : void 0;
+}
+function isTruthyEnv(value) {
+	return /^(1|true|yes|on)$/i.test(value ?? "");
+}
+function isFalsyEnv(value) {
+	return /^(0|false|no|off)$/i.test(value ?? "");
+}
+function isBrowserRuntime() {
+	return typeof window !== "undefined" && typeof document !== "undefined";
+}
+function isProductionTelemetryRuntime() {
+	if (isBrowserRuntime()) return false;
+	const env = getRuntimeEnv();
+	if (!env) return true;
+	if (env.NODE_ENV === "test") return false;
+	if (env.VERCEL_ENV === "production") return true;
+	if (env.CONTEXT === "production" && isTruthyEnv(env.NETLIFY)) return true;
+	if (isTruthyEnv(env.CF_PAGES)) return true;
+	if (env.RENDER_SERVICE_ID || env.FLY_APP_NAME || env.RAILWAY_ENVIRONMENT) return true;
+	return env.NODE_ENV === "production";
+}
+function resolveDocsTelemetryConfig(telemetry) {
+	const envToggle = readRuntimeEnv("DOCS_TELEMETRY");
+	const envDisabled = readRuntimeEnv("DOCS_TELEMETRY_DISABLED");
+	if (isFalsyEnv(envToggle) || isTruthyEnv(envDisabled) || telemetry === false) return { enabled: false };
+	const objectConfig = telemetry && typeof telemetry === "object" ? telemetry : void 0;
+	if (objectConfig?.enabled === false) return { enabled: false };
+	return {
+		enabled: telemetry === true || objectConfig?.enabled === true || isTruthyEnv(envToggle) || isProductionTelemetryRuntime(),
+		endpoint: objectConfig?.endpoint?.trim() || readRuntimeEnv("DOCS_TELEMETRY_ENDPOINT") || DEFAULT_DOCS_TELEMETRY_ENDPOINT
+	};
+}
+function readRequestOrigin(request) {
+	if (!request?.url) return void 0;
+	try {
+		return new URL(request.url).origin;
+	} catch {
+		return;
+	}
+}
+/** Normalize an HTTP(S) telemetry site value to its origin. */
+function normalizeDocsTelemetryOrigin(candidate) {
+	if (typeof candidate !== "string") return void 0;
+	const trimmed = candidate.trim();
+	if (!trimmed) return void 0;
+	try {
+		const hasScheme = /^[a-z][a-z\d+.-]*:(?!\d)/i.test(trimmed);
+		const url = new URL(hasScheme ? trimmed : `https://${trimmed}`);
+		if (url.protocol !== "http:" && url.protocol !== "https:") return void 0;
+		return url.origin;
+	} catch {
+		return;
+	}
+}
+/** Return whether a telemetry origin points at a local development server. */
+function isLocalDocsTelemetryOrigin(candidate) {
+	const origin = normalizeDocsTelemetryOrigin(candidate);
+	if (!origin) return false;
+	const hostname = new URL(origin).hostname.toLowerCase().replace(/^\[|\]$/g, "").replace(/\.+$/, "");
+	if ([
+		"localhost",
+		"localhost.localdomain",
+		"localhost6",
+		"localhost6.localdomain6",
+		"ip6-localhost",
+		"ip6-loopback"
+	].includes(hostname) || hostname.endsWith(".localhost")) return true;
+	if (hostname === "::" || hostname === "::1") return true;
+	const ipv4 = hostname.split(".").map((part) => Number(part));
+	if (ipv4.length === 4 && ipv4.every((part) => Number.isInteger(part) && part >= 0 && part <= 255)) return ipv4[0] === 127 || ipv4.every((part) => part === 0);
+	return /^::ffff:7f[0-9a-f]{2}:/.test(hostname) || hostname === "::ffff:0:0";
+}
+function isBlockedDocsTelemetryOrigin(candidate) {
+	if (candidate === void 0) return false;
+	return !normalizeDocsTelemetryOrigin(candidate) || isLocalDocsTelemetryOrigin(candidate);
+}
+function readDeploymentOrigin() {
+	const candidates = [
+		readRuntimeEnv("DOCS_SITE_URL"),
+		readRuntimeEnv("NEXT_PUBLIC_BASE_URL"),
+		readRuntimeEnv("NEXT_PUBLIC_SITE_URL"),
+		readRuntimeEnv("SITE_URL"),
+		readRuntimeEnv("URL"),
+		readRuntimeEnv("CF_PAGES_URL"),
+		readRuntimeEnv("VERCEL_PROJECT_PRODUCTION_URL"),
+		readRuntimeEnv("VERCEL_URL"),
+		readRuntimeEnv("DEPLOY_PRIME_URL")
+	];
+	for (const candidate of candidates) {
+		const origin = normalizeDocsTelemetryOrigin(candidate);
+		if (origin) return origin;
+	}
+}
+function detectDeployment() {
+	const env = getRuntimeEnv();
+	if (!env) return void 0;
+	if (env.VERCEL || env.VERCEL_ENV) return {
+		provider: "vercel",
+		environment: env.VERCEL_ENV,
+		id: env.VERCEL_DEPLOYMENT_ID ?? env.VERCEL_GIT_COMMIT_SHA,
+		region: env.VERCEL_REGION
+	};
+	if (env.NETLIFY) return {
+		provider: "netlify",
+		environment: env.CONTEXT,
+		id: env.DEPLOY_ID ?? env.COMMIT_REF
+	};
+	if (env.CF_PAGES) return {
+		provider: "cloudflare-pages",
+		environment: env.CF_PAGES_BRANCH,
+		id: env.CF_PAGES_COMMIT_SHA
+	};
+	if (env.RENDER_SERVICE_ID) return {
+		provider: "render",
+		environment: env.RENDER_ENV,
+		id: env.RENDER_SERVICE_ID
+	};
+	if (env.FLY_APP_NAME) return {
+		provider: "fly",
+		environment: env.FLY_APP_NAME,
+		id: env.FLY_ALLOC_ID,
+		region: env.FLY_REGION
+	};
+	if (env.RAILWAY_ENVIRONMENT) return {
+		provider: "railway",
+		environment: env.RAILWAY_ENVIRONMENT,
+		id: env.RAILWAY_DEPLOYMENT_ID
+	};
+	return env.NODE_ENV === "production" ? { environment: "production" } : void 0;
+}
+function detectRuntime() {
+	if (typeof process !== "undefined" && process.versions?.node) return {
+		name: "node",
+		version: process.versions.node
+	};
+	if (typeof navigator !== "undefined" && navigator.userAgent) return { name: "web-standard" };
+}
+function isObjectConfigEnabled(value, defaultEnabled) {
+	if (value === false) return false;
+	if (value === true) return true;
+	if (value && typeof value === "object" && !Array.isArray(value)) {
+		const enabled = value.enabled;
+		return enabled === false ? false : defaultEnabled || enabled === true;
+	}
+	return defaultEnabled;
+}
+function hasObjectConfig(value) {
+	return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+function getDocsTelemetryFeatures(config) {
+	const pageActions = config.pageActions;
+	const feedback = config.feedback;
+	return {
+		search: isObjectConfigEnabled(config.search, true),
+		contentChanges: resolveDocsContentChangesConfig(config.agent?.contentChanges, { staticExport: config.staticExport === true }).enabled,
+		ai: isObjectConfigEnabled(config.ai, false),
+		mcp: isObjectConfigEnabled(config.mcp, true),
+		llmsTxt: isObjectConfigEnabled(config.llmsTxt, true),
+		pageActions: hasObjectConfig(pageActions),
+		feedback: feedback === true || hasObjectConfig(feedback) && feedback.enabled !== false,
+		agentFeedback: feedback !== false && !(hasObjectConfig(feedback) && feedback.agent === false) && !(hasObjectConfig(feedback) && hasObjectConfig(feedback.agent) && feedback.agent.enabled === false),
+		sitemap: isObjectConfigEnabled(config.sitemap, true),
+		robots: isObjectConfigEnabled(config.robots, true),
+		apiReference: isObjectConfigEnabled(config.apiReference, false),
+		staticExport: config.staticExport === true,
+		changelog: isObjectConfigEnabled(config.changelog, false),
+		cloud: typeof config.cloud !== "undefined" && isObjectConfigEnabled(config.cloud, true),
+		review: isObjectConfigEnabled(config.review, true),
+		codeBlocksValidate: hasObjectConfig(config.codeBlocks) && Boolean(config.codeBlocks.validate)
+	};
+}
+function createDocsTelemetryEvent(config, input, context = {}) {
+	const telemetryConfig = config.telemetry && typeof config.telemetry === "object" ? config.telemetry : void 0;
+	const siteOriginCandidates = [
+		context.siteOrigin,
+		input.site?.origin,
+		telemetryConfig?.siteOrigin,
+		readRequestOrigin(context.request),
+		readDeploymentOrigin()
+	];
+	if (siteOriginCandidates.some(isBlockedDocsTelemetryOrigin)) return void 0;
+	const siteOrigin = siteOriginCandidates.map(normalizeDocsTelemetryOrigin).find((origin) => Boolean(origin));
+	const deployment = input.deployment ?? detectDeployment();
+	const properties = context.properties || input.properties ? {
+		...input.properties,
+		...context.properties
+	} : void 0;
+	return {
+		...input,
+		timestamp: input.timestamp ?? (/* @__PURE__ */ new Date()).toISOString(),
+		package: {
+			name: DOCS_PACKAGE_NAME,
+			version: DOCS_PACKAGE_VERSION,
+			...input.package
+		},
+		framework: input.framework ?? context.framework,
+		runtime: input.runtime ?? detectRuntime(),
+		site: siteOrigin ? { origin: siteOrigin } : input.site,
+		deployment,
+		features: input.features ?? getDocsTelemetryFeatures(config),
+		properties
+	};
+}
+function projectEventKey(event) {
+	return [
+		event.package.name,
+		event.package.version,
+		event.framework ?? "",
+		event.site?.origin ?? "",
+		event.deployment?.provider ?? "",
+		event.deployment?.environment ?? "",
+		event.deployment?.id ?? ""
+	].join("|");
+}
+function getSentProjectKeys() {
+	const globalValue = globalThis;
+	globalValue.__farmingLabsDocsTelemetryProjectKeys__ ??= /* @__PURE__ */ new Map();
+	return globalValue.__farmingLabsDocsTelemetryProjectKeys__;
+}
+function pruneSentProjectKeys(sent, now) {
+	for (const [key, expiresAt] of sent) if (expiresAt <= now) sent.delete(key);
+	while (sent.size >= PROJECT_TELEMETRY_CACHE_MAX_KEYS) {
+		const oldestKey = sent.keys().next().value;
+		if (!oldestKey) return;
+		sent.delete(oldestKey);
+	}
+}
+async function emitDocsTelemetryEvent(telemetry, event) {
+	const resolved = resolveDocsTelemetryConfig(telemetry);
+	const eventSiteOrigin = event.site?.origin;
+	const normalizedSiteOrigin = normalizeDocsTelemetryOrigin(eventSiteOrigin);
+	if (!resolved.enabled || !resolved.endpoint || typeof fetch !== "function" || eventSiteOrigin !== void 0 && (!normalizedSiteOrigin || isLocalDocsTelemetryOrigin(eventSiteOrigin))) return;
+	const eventToSend = normalizedSiteOrigin ? {
+		...event,
+		site: { origin: normalizedSiteOrigin }
+	} : event;
+	try {
+		const ingestKey = readRuntimeEnv("DOCS_TELEMETRY_INGEST_KEY");
+		const browserRequest = isBrowserRuntime() && !ingestKey;
+		const headers = { "content-type": browserRequest ? "text/plain;charset=UTF-8" : "application/json" };
+		if (ingestKey) headers["x-docs-telemetry-key"] = ingestKey;
+		await fetch(resolved.endpoint, {
+			method: "POST",
+			headers,
+			body: JSON.stringify({ event: eventToSend }),
+			keepalive: true,
+			...browserRequest ? {
+				credentials: "omit",
+				mode: "no-cors"
+			} : {}
+		});
+	} catch {}
+}
+function emitDocsTelemetryProjectEvent(config, context = {}) {
+	const event = createDocsTelemetryEvent(config, { type: "project_detected" }, context);
+	if (!event) return;
+	const key = projectEventKey(event);
+	const sent = getSentProjectKeys();
+	const now = Date.now();
+	const expiresAt = sent.get(key);
+	if (expiresAt && expiresAt > now) return;
+	if (typeof expiresAt === "number") sent.delete(key);
+	pruneSentProjectKeys(sent, now);
+	sent.set(key, now + PROJECT_TELEMETRY_CACHE_TTL_MS);
+	emitDocsTelemetryEvent(config.telemetry, event);
+}
+/**
+* Emit a privacy-preserving browser page view for the maintainer telemetry dashboard.
+*
+* Page views include only the public site origin, pathname, locale, framework, and package
+* metadata. They never include a query string, referrer, visitor id, IP address, or user agent.
+*/
+function emitDocsTelemetryPageViewEvent(telemetry, context = {}) {
+	if (telemetry === false || telemetry && typeof telemetry === "object" && telemetry.enabled === false) return;
+	const runtimeSiteOrigin = context.siteOrigin ?? (typeof window !== "undefined" ? window.location?.origin : void 0);
+	if (isBlockedDocsTelemetryOrigin(runtimeSiteOrigin)) return;
+	const siteOrigin = (telemetry && typeof telemetry === "object" ? telemetry.siteOrigin : void 0) ?? runtimeSiteOrigin;
+	const event = createDocsTelemetryEvent({ telemetry }, {
+		type: "page_view",
+		features: {},
+		properties: {
+			trafficType: "human",
+			...context.path ? { path: context.path.slice(0, 2048) } : {},
+			...context.locale ? { locale: context.locale.slice(0, 80) } : {}
+		}
+	}, {
+		framework: context.framework,
+		siteOrigin
+	});
+	if (!event) return;
+	emitDocsTelemetryEvent(telemetry && typeof telemetry === "object" ? {
+		...telemetry,
+		enabled: true
+	} : true, event);
+}
+function emitDocsTelemetryAgentSurfaceEvent(config, context) {
+	const event = createDocsTelemetryEvent(config, {
+		type: context.surface === "mcp" ? "mcp_request" : "agent_surface_used",
+		properties: { surface: context.surface }
+	}, context);
+	if (!event) return;
+	emitDocsTelemetryEvent(config.telemetry, event);
+}
+function emitDocsTelemetryMcpToolEvent(config, context) {
+	const event = createDocsTelemetryEvent(config, {
+		type: "mcp_tool_used",
+		properties: {
+			tool: context.tool,
+			locale: context.locale,
+			resultCount: context.resultCount
+		}
+	}, context);
+	if (!event) return;
+	emitDocsTelemetryEvent(config.telemetry, event);
+}
+function inferDocsTelemetryAgentSurface(request, options) {
+	const url = new URL(request.url);
+	const method = request.method.toUpperCase();
+	const feedbackRequest = resolveDocsAgentFeedbackRequest(url, resolveDocsAgentFeedbackConfig(options.feedback));
+	if ((method === "GET" || method === "HEAD") && isDocsAgentDiscoveryRequest(url)) return "agent_spec";
+	if ((method === "GET" || method === "HEAD") && feedbackRequest?.kind === "schema") return "agent_feedback_schema";
+	if (method === "POST" && feedbackRequest?.kind === "submit") return "agent_feedback_submit";
+	if (method === "GET" || method === "HEAD") {
+		if (isDocsContentChangesRequest(url)) return "content_changes";
+		if (isDocsAgentsRequest(url) || resolveDocsAgentsFormat(url) === "agents") return "agents";
+		if (isDocsSkillRequest(url) || resolveDocsSkillFormat(url) === "skill") return "skill";
+		if (resolveDocsMarkdownRequest(options.entry, url, request)) return "markdown";
+		if (resolveDocsLlmsTxtRequest(url, options.llmsTxt, options.entry)) return "llms";
+	}
+	if (method === "POST") return "ask_ai";
+}
+
+//#endregion
+//#region src/sidebar.ts
+function resolvePageSidebarFolderIndexBehavior(sidebar) {
+	if (!sidebar || typeof sidebar !== "object") return void 0;
+	const value = sidebar.folderIndexBehavior;
+	return value === "link" || value === "toggle" || value === "hidden" ? value : void 0;
+}
+function normalizeSidebarFolderBehaviorPath(path) {
+	if (!path) return void 0;
+	let value = path.trim();
+	if (!value) return void 0;
+	if (/^[a-zA-Z][a-zA-Z\d+\-.]*:\/\//.test(value)) try {
+		value = new URL(value).pathname;
+	} catch {
+		return;
+	}
+	else value = value.split("#", 1)[0]?.split("?", 1)[0] ?? value;
+	if (!value.startsWith("/")) value = `/${value}`;
+	return value.replace(/\/$/, "") || "/";
+}
+function resolveSidebarFolderIndexBehavior(sidebar, defaultBehavior = "link") {
+	if (sidebar === void 0 || sidebar === true || sidebar === false) return defaultBehavior;
+	if (sidebar.folderIndexBehavior === "toggle") return "toggle";
+	if (sidebar.folderIndexBehavior === "hidden") return "hidden";
+	if (sidebar.folderIndexBehavior === "link") return "link";
+	return defaultBehavior;
+}
+function resolveSidebarFolderIndexBehaviorForPath(sidebar, folderPath, defaultBehavior = "link") {
+	const fallback = resolveSidebarFolderIndexBehavior(sidebar, defaultBehavior);
+	if (!sidebar || typeof sidebar !== "object") return fallback;
+	const normalizedPath = normalizeSidebarFolderBehaviorPath(folderPath);
+	if (!normalizedPath) return fallback;
+	for (const [rawPath, override] of Object.entries(sidebar.folderIndexBehaviorOverrides ?? {})) if (normalizeSidebarFolderBehaviorPath(rawPath) === normalizedPath) return override === "link" || override === "toggle" || override === "hidden" ? override : fallback;
+	return fallback;
+}
+function applySidebarFolderIndexBehavior(tree, behaviorOrOptions) {
+	const resolveBehavior = typeof behaviorOrOptions === "string" ? () => behaviorOrOptions : (folderPath) => resolveSidebarFolderIndexBehaviorForPath(behaviorOrOptions.sidebar, folderPath, behaviorOrOptions.defaultBehavior);
+	function mapNode(node) {
+		if (!node || typeof node !== "object") return node;
+		const candidate = node;
+		if (candidate.type !== "folder" || !Array.isArray(candidate.children)) return node;
+		const children = candidate.children.map(mapNode);
+		const index = candidate.index ? mapNode(candidate.index) : void 0;
+		const folderPath = (typeof candidate.url === "string" ? candidate.url : void 0) || (candidate.index && typeof candidate.index === "object" && "url" in candidate.index && typeof candidate.index.url === "string" ? candidate.index.url ?? void 0 : void 0);
+		const behavior = (candidate.folderIndexBehavior === "link" || candidate.folderIndexBehavior === "toggle" || candidate.folderIndexBehavior === "hidden" ? candidate.folderIndexBehavior : void 0) ?? resolveBehavior(folderPath);
+		if (behavior === "link") return {
+			...candidate,
+			folderIndexBehavior: void 0,
+			index,
+			children
+		};
+		if (behavior === "hidden") return {
+			...candidate,
+			folderIndexBehavior: void 0,
+			index: void 0,
+			url: void 0,
+			children
+		};
+		return {
+			...candidate,
+			folderIndexBehavior: void 0,
+			index: void 0,
+			url: void 0,
+			children: index ? [index, ...children] : children
+		};
+	}
+	return {
+		...tree,
+		children: tree.children.map(mapNode)
+	};
+}
+
+//#endregion
+export { emitDocsTelemetryAgentSurfaceEvent as a, emitDocsTelemetryPageViewEvent as c, inferDocsTelemetryAgentSurface as d, isLocalDocsTelemetryOrigin as f, resolveSidebarFolderIndexBehaviorForPath as i, emitDocsTelemetryProjectEvent as l, resolveDocsTelemetryConfig as m, resolvePageSidebarFolderIndexBehavior as n, emitDocsTelemetryEvent as o, normalizeDocsTelemetryOrigin as p, resolveSidebarFolderIndexBehavior as r, emitDocsTelemetryMcpToolEvent as s, applySidebarFolderIndexBehavior as t, getDocsTelemetryFeatures as u };

package/dist/{sitemap-Bc4LkIcm.mjs → sitemap-CBQoERNz.mjs}

@@ -1,17 +1,21 @@
-import "./markdown-sections-BKy4labo.mjs";
-import { It as renderDocsSitemapMarkdown, Lt as renderDocsSitemapXml, Nt as buildDocsSitemapManifest, Rt as resolveDocsSitemapConfig } from "./agent-CEZCaYto.mjs";
-import "./standards-discovery-Bpz90VYq.mjs";
-import "./openapi-mcp-UF4Cx885.mjs";
-import "./sitemap-server-C4bpuoLi.mjs";
-import "./api-reference-0XdEWya8.mjs";
-import "./agent-skills-server-Ddm90WL6.mjs";
-import "./agent-evals-CmeTjDMC.mjs";
+import "./http-body-DkAPk6D5.mjs";
+import "./markdown-sections-9Oxr33b-.mjs";
+import { It as renderDocsSitemapMarkdown, Lt as renderDocsSitemapXml, Nt as buildDocsSitemapManifest, Rt as resolveDocsSitemapConfig } from "./agent-DkAidqtV.mjs";
+import "./standards-discovery-sSEojU80.mjs";
+import "./sidebar-CFHBj29f.mjs";
+import "./openapi-mcp-BIOTLiA7.mjs";
+import "./prompt-utils-B5g-bv7o.mjs";
+import "./api-reference-By_LokQ-.mjs";
+import "./agent-skills-server-BC7md56k.mjs";
+import "./agent-evals-BLNLvXbG.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
-import "./authoring-mcp-C35lj3cI.mjs";
+import "./authoring-mcp-CiCUQe3o.mjs";
+import "./cloud-ask-ai-BqKhjpS5.mjs";
 import "./code-blocks-GYdvS3BH.mjs";
+import "./sitemap-server-Lg3YhUx4.mjs";
 import "./server.mjs";
-import { _ as resolveDocsContentDir, a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-BnUOoj07.mjs";
-import { t as detectFramework } from "./utils-c9arebCi.mjs";
+import { _ as resolveDocsContentDir, a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-BZnKAj_Y.mjs";
+import { t as detectFramework } from "./utils-C7KDrPpA.mjs";
 import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import { execFileSync } from "node:child_process";

package/dist/sitemap-DafdOrxK.d.mts

@@ -0,0 +1,110 @@
+import { oi as ResolvedDocsRelatedLink, yr as DocsSitemapConfig } from "./types-BncG8J3g.mjs";
+import { R as DocsDiscoveryApiRouteOptions } from "./standards-discovery-1fiUVDAo.mjs";
+
+//#region src/sitemap.d.ts
+declare const DEFAULT_SITEMAP_XML_ROUTE = "/sitemap.xml";
+declare const DEFAULT_SITEMAP_MD_ROUTE = "/sitemap.md";
+declare const DEFAULT_SITEMAP_MD_DOCS_ROUTE = "/docs/sitemap.md";
+declare const DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE = "/.well-known/sitemap.md";
+declare const DEFAULT_SITEMAP_MANIFEST_PATH = ".farming-labs/sitemap-manifest.json";
+type DocsSitemapFormat = "xml" | "markdown";
+interface DocsSitemapPageInput {
+  slug?: string;
+  url: string;
+  /** Override the public Markdown representation URL when it differs from `${url}.md`. */
+  markdownUrl?: string;
+  title: string;
+  description?: string;
+  related?: ResolvedDocsRelatedLink[];
+  sourcePath?: string;
+  lastmod?: string;
+  lastModified?: string;
+}
+interface DocsSitemapManifestPage {
+  url: string;
+  absoluteUrl?: string;
+  markdownUrl: string;
+  title: string;
+  description?: string;
+  sourcePath?: string;
+  lastmod?: string;
+  lastmodSource?: "git" | "filesystem" | "frontmatter" | "manifest" | "unknown";
+  related?: string[];
+}
+interface DocsSitemapManifest {
+  version: 1;
+  generatedAt: string;
+  baseUrl?: string;
+  entry: string;
+  siteTitle?: string;
+  pages: DocsSitemapManifestPage[];
+}
+interface DocsSitemapResolvedConfig {
+  enabled: boolean;
+  routePrefix: string;
+  baseUrl?: string;
+  manifestPath: string;
+  xml: {
+    enabled: boolean;
+    includeLastmod: boolean;
+    route: string;
+  };
+  markdown: {
+    enabled: boolean;
+    includeDescriptions: boolean;
+    includeLastmod: boolean;
+    linkTarget: "html" | "markdown" | "both";
+    route: string;
+    docsRoute?: string;
+    wellKnownRoute: string;
+  };
+}
+interface CreateDocsSitemapResponseOptions extends DocsDiscoveryApiRouteOptions {
+  request: Request;
+  sitemap?: boolean | DocsSitemapConfig;
+  entry?: string;
+  siteTitle?: string;
+  baseUrl?: string;
+  pages: DocsSitemapPageInput[];
+  manifest?: DocsSitemapManifest | null;
+}
+declare function resolveDocsSitemapConfig(sitemap?: boolean | DocsSitemapConfig, defaults?: {
+  baseUrl?: string;
+}): DocsSitemapResolvedConfig;
+declare function resolveDocsSitemapRequest(url: URL, sitemap?: boolean | DocsSitemapConfig, options?: DocsDiscoveryApiRouteOptions): DocsSitemapFormat | null;
+declare function toDocsSitemapMarkdownUrl(url: string): string;
+declare function buildDocsSitemapManifest(options: {
+  pages: DocsSitemapPageInput[];
+  entry?: string;
+  siteTitle?: string;
+  baseUrl?: string;
+  generatedAt?: string;
+  resolveLastmod?: (page: DocsSitemapPageInput) => {
+    lastmod?: string;
+    lastmodSource?: DocsSitemapManifestPage["lastmodSource"];
+  } | undefined;
+}): DocsSitemapManifest;
+declare function renderDocsSitemapXml(manifest: DocsSitemapManifest, options?: {
+  baseUrl?: string;
+  includeLastmod?: boolean;
+}): string;
+declare function renderDocsSitemapMarkdown(manifest: DocsSitemapManifest, options?: {
+  baseUrl?: string;
+  includeDescriptions?: boolean;
+  includeLastmod?: boolean;
+  linkTarget?: "html" | "markdown" | "both";
+}): string;
+declare function readDocsSitemapManifestFromContentMap(contentMap?: Record<string, string> | null): DocsSitemapManifest | null;
+declare function resolveDocsSitemapPageLastmod(manifest: DocsSitemapManifest | null | undefined, url: string): string | undefined;
+declare function createDocsSitemapResponse({
+  request,
+  apiRoute,
+  sitemap,
+  entry,
+  siteTitle,
+  baseUrl,
+  pages,
+  manifest
+}: CreateDocsSitemapResponseOptions): Response | null;
+//#endregion
+export { resolveDocsSitemapPageLastmod as _, DEFAULT_SITEMAP_XML_ROUTE as a, DocsSitemapManifestPage as c, buildDocsSitemapManifest as d, createDocsSitemapResponse as f, resolveDocsSitemapConfig as g, renderDocsSitemapXml as h, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as i, DocsSitemapPageInput as l, renderDocsSitemapMarkdown as m, DEFAULT_SITEMAP_MD_DOCS_ROUTE as n, DocsSitemapFormat as o, readDocsSitemapManifestFromContentMap as p, DEFAULT_SITEMAP_MD_ROUTE as r, DocsSitemapManifest as s, DEFAULT_SITEMAP_MANIFEST_PATH as t, DocsSitemapResolvedConfig as u, resolveDocsSitemapRequest as v, toDocsSitemapMarkdownUrl as y };

package/dist/sitemap-server-C9r22_06.d.mts

@@ -0,0 +1,114 @@
+import { Ht as DocsConfig, a as ApiReferenceRenderer, gr as DocsSearchSourcePage, vn as DocsOkfConfig, wn as DocsOpenApiMcpConfig, yr as DocsSitemapConfig } from "./types-BncG8J3g.mjs";
+import { s as DocsSitemapManifest } from "./sitemap-DafdOrxK.mjs";
+
+//#region src/api-reference.d.ts
+type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "HEAD";
+type ApiReferenceFramework = "next" | "tanstack-start" | "farmjs" | "sveltekit" | "astro" | "nuxt";
+interface ApiReferenceRoute {
+  title: string;
+  summary: string;
+  description?: string;
+  routePath: string;
+  sourceFile: string;
+  methods: HttpMethod[];
+  tag: string;
+  parameters: Array<Record<string, unknown>>;
+}
+interface ResolvedApiReferenceConfig {
+  enabled: boolean;
+  path: string;
+  specUrl?: string;
+  overlays: string[];
+  versions: ResolvedApiReferenceVersion[];
+  defaultVersion?: string;
+  catalogTargets?: string[];
+  renderer?: ApiReferenceRenderer;
+  mcp?: DocsOpenApiMcpConfig;
+  routeRoot: string;
+  exclude: string[];
+}
+interface ResolvedApiReferenceVersion {
+  id: string;
+  label: string;
+  specUrl: string;
+  overlays: string[];
+  default: boolean;
+}
+interface ApiReferenceOpenApiVersionDiscovery {
+  id: string;
+  label: string;
+  default: boolean;
+  url: string;
+  apiReferencePath: string;
+  specUrl?: string;
+  operationCount?: number;
+}
+interface ApiReferenceOpenApiDiscovery {
+  enabled: boolean;
+  url?: string;
+  urlSource?: "default" | "configured";
+  source?: "generated" | "configured";
+  specUrl?: string;
+  apiReferencePath?: string;
+  catalogTargets?: string[];
+  operationCount?: number;
+  versions?: ApiReferenceOpenApiVersionDiscovery[];
+}
+interface BuildApiReferenceOptions {
+  framework: ApiReferenceFramework;
+  rootDir?: string;
+  baseUrl?: string;
+  version?: string;
+}
+interface BuildApiReferenceOperationPagesOptions extends Omit<BuildApiReferenceOptions, "version"> {
+  /** Locale attached to generated search records in localized documentation sites. */
+  locale?: string;
+}
+interface CreateApiReferenceOperationMarkdownResponseOptions extends BuildApiReferenceOperationPagesOptions {
+  request: Request;
+  /** Shared Docs API pathname used by query-form Markdown requests. @default "/api/docs" */
+  apiRoute?: string;
+  /** Public metadata origin. Defaults to `baseUrl`, then the request origin. */
+  origin?: string;
+  /** Authored pages included in Markdown recovery suggestions. */
+  pages?: DocsSearchSourcePage[];
+  /** Reuse a cached operation projection when the adapter already maintains one. */
+  operationPages?: DocsSearchSourcePage[] | (() => DocsSearchSourcePage[] | Promise<DocsSearchSourcePage[]>);
+  sitemap?: boolean | DocsSitemapConfig;
+  okf?: boolean | DocsOkfConfig;
+}
+interface BuildApiReferenceHtmlOptions extends BuildApiReferenceOptions {
+  title?: string;
+}
+declare const DEFAULT_API_REFERENCE_OPENAPI_ROUTE = "/api/docs?format=openapi";
+declare function resolveApiReferenceConfig(value: DocsConfig["apiReference"]): ResolvedApiReferenceConfig;
+declare function resolveApiReferenceRenderer(value: DocsConfig["apiReference"], _framework: ApiReferenceFramework): ApiReferenceRenderer;
+declare function resolveApiReferenceOpenApiDiscovery(value: DocsConfig["apiReference"], options?: {
+  route?: string;
+}): ApiReferenceOpenApiDiscovery;
+declare function resolveApiReferenceVersion(config: ResolvedApiReferenceConfig, requestedVersion?: string): ResolvedApiReferenceVersion | undefined;
+declare function resolveApiReferenceVersionFromPathname(value: DocsConfig["apiReference"], pathname: string): ResolvedApiReferenceVersion | undefined;
+declare function isApiReferenceOpenApiRequest(url: URL): boolean;
+declare function buildApiReferencePageTitle(config: DocsConfig, title?: string): string;
+declare function buildApiReferenceScalarCss(config: DocsConfig): string;
+declare function buildApiReferenceOpenApiDocument(config: DocsConfig, options: BuildApiReferenceOptions): Record<string, unknown>;
+declare function buildApiReferenceOpenApiDocumentAsync(config: DocsConfig, options: BuildApiReferenceOptions): Promise<Record<string, unknown>>;
+/**
+ * Build deterministic, operation-level source pages from every configured OpenAPI version.
+ *
+ * These pages are framework-neutral projections used by documentation search and other
+ * read-only knowledge surfaces. They never inherit MCP execution headers or credentials.
+ */
+declare function buildApiReferenceOperationPagesAsync(config: DocsConfig, options: BuildApiReferenceOperationPagesOptions): Promise<DocsSearchSourcePage[]>;
+/**
+ * Resolve a public per-operation Markdown request using the same generated projection as search,
+ * Ask AI, and MCP. Returns `null` when the request is not an API operation Markdown route.
+ */
+declare function createApiReferenceOperationMarkdownResponse(config: DocsConfig, options: CreateApiReferenceOperationMarkdownResponseOptions): Promise<Response | null>;
+declare function buildApiReferenceHtmlDocument(config: DocsConfig, options: BuildApiReferenceHtmlOptions): string;
+declare function buildApiReferenceHtmlDocumentAsync(config: DocsConfig, options: BuildApiReferenceHtmlOptions): Promise<string>;
+//#endregion
+//#region src/sitemap-server.d.ts
+declare function readDocsSitemapManifest(rootDir: string, sitemap?: boolean | DocsSitemapConfig): DocsSitemapManifest | null;
+//#endregion
+export { resolveApiReferenceRenderer as C, resolveApiReferenceOpenApiDiscovery as S, resolveApiReferenceVersionFromPathname as T, buildApiReferencePageTitle as _, ApiReferenceRoute as a, isApiReferenceOpenApiRequest as b, CreateApiReferenceOperationMarkdownResponseOptions as c, ResolvedApiReferenceVersion as d, buildApiReferenceHtmlDocument as f, buildApiReferenceOperationPagesAsync as g, buildApiReferenceOpenApiDocumentAsync as h, ApiReferenceOpenApiVersionDiscovery as i, DEFAULT_API_REFERENCE_OPENAPI_ROUTE as l, buildApiReferenceOpenApiDocument as m, ApiReferenceFramework as n, BuildApiReferenceOperationPagesOptions as o, buildApiReferenceHtmlDocumentAsync as p, ApiReferenceOpenApiDiscovery as r, BuildApiReferenceOptions as s, readDocsSitemapManifest as t, ResolvedApiReferenceConfig as u, buildApiReferenceScalarCss as v, resolveApiReferenceVersion as w, resolveApiReferenceConfig as x, createApiReferenceOperationMarkdownResponse as y };