import { $ as DocsObservabilityEventInput, $t as SimpleDocsSearchConfig, A as DocsCloudApiKeyConfig, At as McpDocsSearchConfig, B as DocsCodeBlocksValidateConfig, Bt as PageFrontmatter, C as DocsAskAIActionData, Ct as FontStyle, D as DocsAskAIFeedbackMessage, Dt as LlmsTxtMaxCharsConfig, E as DocsAskAIFeedbackData, Et as LlmsTxtConfig, F as DocsCodeBlocksConfig, Ft as OpenDocsProviderId, G as DocsFeedbackValue, Gt as ResolvedDocsRelatedLink, H as DocsCodeBlocksValidationPolicy, Ht as PageSidebarFrontmatter, I as DocsCodeBlocksPlannerConfig, It as OpenDocsTarget, J as DocsMcpToolsConfig, Jt as SidebarFolderIndexBehavior, K as DocsI18nConfig, Kt as SidebarComponentProps, L as DocsCodeBlocksPlannerProvider, Lt as OpenGraphImage, M as DocsCloudFeatureConfig, Mt as OpenDocsConfig, N as DocsCloudPreviewConfig, Nt as OpenDocsProvider, O as DocsAskAIFeedbackValue, Ot as LlmsTxtMaxCharsMode, P as DocsCloudPublishConfig, Pt as OpenDocsProviderConfig, Q as DocsObservabilityEvent, Qt as SidebarTree, R as DocsCodeBlocksRunnerConfig, Rt as OrderingItem, S as DocsAnalyticsSource, St as FeedbackConfig, T as DocsAskAIFeedbackConfig, Tt as LastUpdatedConfig, U as DocsConfig, Ut as PageTwitter, V as DocsCodeBlocksValidationMode, Vt as PageOpenGraph, W as DocsFeedbackData, Wt as ReadingTimeConfig, X as DocsNav, Xt as SidebarNode, Y as DocsMetadata, Yt as SidebarFolderNode, Z as DocsObservabilityConfig, Zt as SidebarPageNode, _ as DocsAnalyticsConfig, _t as DocsSearchResult, a as ApiReferenceRenderer, at as DocsReviewScoreConfig, b as DocsAnalyticsEventType, bt as DocsSitemapConfig, c as ChangelogFrontmatter, ct as DocsRobotsRule, d as CustomDocsSearchConfig, dt as DocsSearchAdapterFactory, en as ThemeToggleConfig, et as DocsRelatedItem, f as DocsAgentFeedbackContext, ft as DocsSearchChunkingConfig, g as DocsAgentTraceStatus, gt as DocsSearchQuery, h as DocsAgentTraceEventType, ht as DocsSearchEmbeddingsConfig, i as ApiReferenceConfig, it as DocsReviewRulesConfig, j as DocsCloudConfig, jt as OGConfig, k as DocsAskAIMcpConfig, kt as LlmsTxtSectionConfig, l as CodeBlockCopyData, lt as DocsSearchAdapter, m as DocsAgentTraceEventInput, mt as DocsSearchDocument, n as AgentFeedbackConfig, nn as TypographyConfig, nt as DocsReviewCiMode, o as BreadcrumbConfig, ot as DocsReviewSeverity, p as DocsAgentFeedbackData, pt as DocsSearchConfig, q as DocsMcpConfig, qt as SidebarConfig, r as AlgoliaDocsSearchConfig, rn as UIConfig, rt as DocsReviewConfig, s as ChangelogConfig, st as DocsRobotsConfig, t as AIConfig, tn as TypesenseDocsSearchConfig, tt as DocsReviewCiConfig, u as CopyMarkdownConfig, ut as DocsSearchAdapterContext, v as DocsAnalyticsEvent, vt as DocsSearchResultType, w as DocsAskAIActionType, wt as GithubConfig, x as DocsAnalyticsInput, xt as DocsTheme, y as DocsAnalyticsEventInput, yt as DocsSearchSourcePage, z as DocsCodeBlocksRunnerProvider, zt as PageActionsConfig } from "./types-DooUSWkW.mjs";
import { $ as createDocsAgentTraceId, A as resolveDocsSitemapRequest, C as buildDocsSitemapManifest, D as renderDocsSitemapXml, E as renderDocsSitemapMarkdown, I as PromptAction, J as DOCS_AGENT_TRACE_EVENT_TYPES, L as PromptProviderChoice, O as resolveDocsSitemapConfig, Q as createDocsAgentTraceContext, R as SerializeOpenDocsProviderOptions, S as DocsSitemapResolvedConfig, T as readDocsSitemapManifestFromContentMap, X as ResolvedDocsAnalyticsConfig, Y as DocsAgentTraceContext, Z as ResolvedDocsObservabilityConfig, _ as DEFAULT_SITEMAP_XML_ROUTE, a as createMcpSearchAdapter, at as resolveDocsObservabilityConfig, b as DocsSitemapManifestPage, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, et as emitDocsAgentTraceEvent, f as resolveSearchRequestConfig, g as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, h as DEFAULT_SITEMAP_MD_ROUTE, i as createCustomSearchAdapter, it as resolveDocsAnalyticsConfig, j as toDocsSitemapMarkdownUrl, k as resolveDocsSitemapPageLastmod, l as inferDocsAskAIPackageHints, m as DEFAULT_SITEMAP_MD_DOCS_ROUTE, n as buildDocsSearchDocuments, nt as emitDocsObservabilityEvent, o as createSimpleSearchAdapter, p as DEFAULT_SITEMAP_MANIFEST_PATH, r as createAlgoliaSearchAdapter, rt as getDocsRequestAnalyticsProperties, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, tt as emitDocsAnalyticsEvent, u as performDocsSearch, v as DocsSitemapFormat, w as createDocsSitemapResponse, x as DocsSitemapPageInput, y as DocsSitemapManifest, z as SerializedOpenDocsProvider } from "./search-vwey5r8r.mjs";
import { DocsMcpPage, DocsMcpResolvedConfig } from "./mcp.mjs";

//#region src/define-docs.d.ts
/**
 * Define docs configuration. Validates and returns the config.
 */
declare function defineDocs(config: DocsConfig): DocsConfig;
//#endregion
//#region src/changelog.d.ts
interface ResolvedChangelogConfig {
  enabled: boolean;
  path: string;
  contentDir: string;
  title: string;
  description?: string;
  search: boolean;
  actionsComponent?: unknown;
}
interface ChangelogEntrySummary extends ChangelogFrontmatter {
  slug: string;
  date: string;
  url: string;
}
declare function resolveChangelogConfig(value: DocsConfig["changelog"]): ResolvedChangelogConfig;
//#endregion
//#region src/utils.d.ts
/**
 * Deep merge utility for theme overrides.
 * Merges objects recursively; later values override earlier ones.
 */
declare function deepMerge<T extends Record<string, unknown>>(target: T, ...sources: Partial<T>[]): T;
//#endregion
//#region src/create-theme.d.ts
/**
 * Create a theme preset factory.
 *
 * Returns a function that accepts optional overrides and deep-merges them
 * with the base theme defaults. This is the same pattern used by the
 * built-in `fumadocs()`, `darksharp()`, and `pixelBorder()` presets.
 *
 * @param baseTheme - The default theme configuration
 * @returns A factory function `(overrides?) => DocsTheme`
 *
 * @example
 * ```ts
 * import { createTheme } from "@farming-labs/docs";
 *
 * export const myTheme = createTheme({
 *   name: "my-theme",
 *   ui: {
 *     colors: { primary: "#6366f1" },
 *     layout: { contentWidth: 800 },
 *   },
 * });
 * ```
 */
declare function createTheme(baseTheme: DocsTheme): (overrides?: Partial<DocsTheme>) => DocsTheme;
/**
 * Extend an existing theme preset with additional defaults.
 *
 * Useful when you want to build on top of an existing theme (e.g. fumadocs)
 * rather than starting from scratch.
 *
 * @example
 * ```ts
 * import { extendTheme } from "@farming-labs/docs";
 * import { fumadocs } from "@farming-labs/theme/default";
 *
 * // Start with fumadocs defaults, override some values
 * export const myTheme = extendTheme(fumadocs(), {
 *   name: "my-custom-fumadocs",
 *   ui: { colors: { primary: "#22c55e" } },
 * });
 * ```
 */
declare function extendTheme(baseTheme: DocsTheme, extensions: Partial<DocsTheme>): DocsTheme;
//#endregion
//#region src/i18n.d.ts
interface ResolvedDocsI18n {
  locales: string[];
  defaultLocale: string;
}
interface DocsPathMatch {
  /** Slug path relative to the docs root (no leading slash). */
  slug: string;
  /** Entry path used for URLs (no locale segment). */
  entryPath: string;
}
declare function resolveDocsI18n(config?: DocsI18nConfig | null): ResolvedDocsI18n | null;
declare function resolveDocsLocale(searchParams: URLSearchParams, i18n?: ResolvedDocsI18n | null): string | undefined;
declare function resolveDocsPath(pathname: string, entry: string): DocsPathMatch;
//#endregion
//#region src/metadata.d.ts
interface DocsStructuredDataBreadcrumb {
  name: string;
  url: string;
}
interface DocsPageStructuredDataInput {
  title: string;
  description?: string;
  url: string;
  baseUrl?: string;
  entry?: string;
  dateModified?: string;
  breadcrumbs?: DocsStructuredDataBreadcrumb[];
}
/**
 * Resolve page title using metadata titleTemplate.
 * %s is replaced with page title.
 */
declare function resolveTitle(pageTitle: string, metadata?: DocsMetadata): string;
/**
 * Resolve OG image URL for a page.
 * Prefers page.openGraph.images[0], then page.ogImage, then config endpoint/default.
 */
declare function resolveOGImage(page: PageFrontmatter, ogConfig?: OGConfig, baseUrl?: string): string | undefined;
/**
 * Build the Open Graph metadata object for a page.
 * When the page has openGraph in frontmatter, uses it (with title/description filled from page if omitted).
 * Otherwise uses ogImage or config (dynamic endpoint / defaultImage).
 */
declare function buildPageOpenGraph(page: Pick<PageFrontmatter, "title" | "description" | "ogImage" | "openGraph">, ogConfig?: OGConfig, baseUrl?: string): PageOpenGraph | undefined;
/**
 * Build the Twitter card metadata object for a page.
 * When the page has twitter in frontmatter, uses it.
 * Otherwise builds from ogImage or config (dynamic endpoint).
 */
declare function buildPageTwitter(page: Pick<PageFrontmatter, "title" | "description" | "ogImage" | "openGraph" | "twitter">, ogConfig?: OGConfig, baseUrl?: string): PageTwitter | undefined;
/**
 * Resolve the public docs site URL from existing agent-facing config.
 *
 * The framework intentionally reuses `sitemap.baseUrl`, `llmsTxt.baseUrl`,
 * `robots.baseUrl`, or `ai.docsUrl` instead of requiring another setting.
 */
declare function resolveDocsMetadataBaseUrl(config: DocsConfig): string | undefined;
/**
 * Build Schema.org JSON-LD for a docs page.
 *
 * The shape follows Vercel's agent readability guidance: a `TechArticle`
 * with title, description, canonical URL, freshness, and breadcrumbs.
 */
declare function buildDocsPageStructuredData(input: DocsPageStructuredDataInput): Record<string, unknown>;
/**
 * Serialize Schema.org JSON-LD for safe insertion into a `<script>` tag.
 */
declare function renderDocsPageStructuredDataJson(input: DocsPageStructuredDataInput): string;
//#endregion
//#region src/reading-time.d.ts
interface ResolvedReadingTimeOptions {
  enabled: boolean;
  wordsPerMinute?: number;
}
declare function estimateReadingTimeMinutes(content: string, wordsPerMinute?: number): number;
declare function resolveReadingTimeOptions(readingTime: boolean | ReadingTimeConfig | null | undefined): ResolvedReadingTimeOptions;
declare function resolveReadingTimeFromContent(frontmatter: Partial<PageFrontmatter> | undefined, content: string, wordsPerMinute?: number): number | null;
declare function resolvePageReadingTime(frontmatter: Partial<PageFrontmatter> | undefined, content: string, options?: {
  enabledByDefault?: boolean;
  wordsPerMinute?: number;
}): number | null | undefined;
declare function resolveReadingTimeFromSource(source: string, wordsPerMinute?: number): number | null;
//#endregion
//#region src/related.d.ts
declare function normalizeDocsRelated(value: unknown): ResolvedDocsRelatedLink[];
declare function renderDocsRelatedMarkdownLines(related: ResolvedDocsRelatedLink[] | undefined): string[];
//#endregion
//#region src/sidebar.d.ts
interface SidebarFolderIndexBehaviorOptions {
  sidebar: boolean | SidebarConfig | undefined;
  defaultBehavior?: SidebarFolderIndexBehavior;
}
declare function resolvePageSidebarFolderIndexBehavior(sidebar: unknown): SidebarFolderIndexBehavior | undefined;
declare function resolveSidebarFolderIndexBehavior(sidebar: boolean | SidebarConfig | undefined, defaultBehavior?: SidebarFolderIndexBehavior): SidebarFolderIndexBehavior;
declare function resolveSidebarFolderIndexBehaviorForPath(sidebar: boolean | SidebarConfig | undefined, folderPath: string | undefined, defaultBehavior?: SidebarFolderIndexBehavior): SidebarFolderIndexBehavior;
declare function applySidebarFolderIndexBehavior<TTree extends {
  children: unknown[];
}>(tree: TTree, behaviorOrOptions: SidebarFolderIndexBehavior | SidebarFolderIndexBehaviorOptions): TTree;
//#endregion
//#region src/agent-provenance.d.ts
declare const GENERATED_AGENT_PROVENANCE_MARKER = "@farming-labs/docs:generated";
declare const GENERATED_AGENT_PROVENANCE_VERSION = 1;
type GeneratedAgentSourceKind = "resolved-page" | "agent-md";
interface GeneratedAgentProvenance {
  version: number;
  sourceKind: GeneratedAgentSourceKind;
  sourceHash: string;
  settingsHash: string;
  outputHash: string;
  generatedAt: string;
}
interface ParsedGeneratedAgentDocument {
  provenance?: GeneratedAgentProvenance;
  content: string;
}
declare function normalizeGeneratedAgentContent(value: string): string;
declare function hashGeneratedAgentContent(value: string): string;
declare function parseGeneratedAgentDocument(raw: string): ParsedGeneratedAgentDocument;
declare function stripGeneratedAgentProvenance(raw: string): string;
declare function serializeGeneratedAgentDocument(content: string, provenance: GeneratedAgentProvenance): string;
//#endregion
//#region src/agent.d.ts
declare const DEFAULT_DOCS_API_ROUTE = "/api/docs";
declare const DEFAULT_OPENAPI_SCHEMA_ROUTE = "/api/docs?format=openapi";
declare const DEFAULT_AGENT_SPEC_ROUTE = "/api/docs/agent/spec";
declare const DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE = "/.well-known/agent";
declare const DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE = "/.well-known/agent.json";
declare const DEFAULT_MCP_ROUTE = "/api/docs/mcp";
declare const DEFAULT_MCP_PUBLIC_ROUTE = "/mcp";
declare const DEFAULT_MCP_WELL_KNOWN_ROUTE = "/.well-known/mcp";
declare const DEFAULT_LLMS_TXT_ROUTE = "/llms.txt";
declare const DEFAULT_LLMS_FULL_TXT_ROUTE = "/llms-full.txt";
declare const DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE = "/.well-known/llms.txt";
declare const DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE = "/.well-known/llms-full.txt";
declare const DEFAULT_LLMS_TXT_MAX_CHARS = 50000;
declare const DEFAULT_SKILL_MD_ROUTE = "/skill.md";
declare const DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE = "/.well-known/skill.md";
declare const DEFAULT_AGENTS_MD_ROUTE = "/AGENTS.md";
declare const DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE = "/.well-known/AGENTS.md";
declare const DEFAULT_AGENT_MD_ROUTE = "/AGENT.md";
declare const DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE = "/.well-known/AGENT.md";
declare const DEFAULT_AGENT_FEEDBACK_ROUTE = "/api/docs/agent/feedback";
declare const DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA: Record<string, unknown>;
declare const DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER = "Signature-Agent";
declare const DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN: string;
declare const DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN: string;
declare const DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN: string;
interface DocsMcpEndpointCandidate {
  baseUrl: string;
  route: string;
  url: string;
  label: string;
}
interface DocsMcpEndpointCandidateOptions {
  includeOriginFallback?: boolean;
  includeRootDomainFallback?: boolean;
  includeMcpSubdomainFallback?: boolean;
}
interface DocsAgentFeedbackResolvedConfig {
  enabled: boolean;
  route: string;
  schemaRoute: string;
  payloadSchema: Record<string, unknown>;
  schema: Record<string, unknown>;
  onFeedback?: (data: DocsAgentFeedbackData) => void | Promise<void>;
}
interface DocsAgentFeedbackRequest {
  kind: "schema" | "submit";
}
interface DocsAgentFeedbackDiscoveryConfig {
  enabled?: boolean;
  route?: string;
  schemaRoute?: string;
}
interface DocsLlmsDiscoveryConfig {
  enabled?: boolean;
  baseUrl?: string;
  siteTitle?: string;
  siteDescription?: string;
  maxChars?: LlmsTxtMaxCharsConfig;
  sections?: LlmsTxtSectionConfig[];
  openapi?: boolean | DocsOpenApiDiscoveryConfig;
}
interface DocsOpenApiDiscoveryConfig {
  enabled?: boolean;
  url?: string;
  source?: "generated" | "configured";
  specUrl?: string;
  apiReferencePath?: string;
}
interface DocsOpenApiResolvedDiscoveryConfig {
  enabled: boolean;
  url?: string;
  source?: "generated" | "configured";
  specUrl?: string;
  apiReferencePath?: string;
}
interface DocsLlmsTxtResolvedMaxChars {
  mode: LlmsTxtMaxCharsMode;
  chars: number;
}
interface DocsLlmsTxtResolvedSection {
  title: string;
  description?: string;
  match: string[];
  route: string;
  fullRoute: string;
  maxChars: DocsLlmsTxtResolvedMaxChars;
}
interface DocsLlmsTxtRequest {
  format: "llms" | "llms-full";
  section?: DocsLlmsTxtResolvedSection;
}
interface DocsLlmsTxtPageInput {
  url: string;
  title: string;
  description?: string;
  content: string;
}
interface DocsLlmsTxtGeneratedSection extends DocsLlmsTxtResolvedSection {
  llmsTxt: string;
  llmsFullTxt: string;
}
interface DocsLlmsTxtGeneratedContent {
  llmsTxt: string;
  llmsFullTxt: string;
  maxChars: DocsLlmsTxtResolvedMaxChars;
  sections: DocsLlmsTxtGeneratedSection[];
}
interface DocsLlmsTxtSelectedContent {
  content: string;
  label: string;
  maxChars: DocsLlmsTxtResolvedMaxChars;
}
interface DocsLlmsTxtMaxCharsIssue {
  mode: Exclude<LlmsTxtMaxCharsMode, "off">;
  chars: number;
  actual: number;
  label: string;
  message: string;
}
interface DocsAgentDiscoverySpecOptions {
  origin: string;
  entry?: string;
  i18n?: ResolvedDocsI18n | null;
  search?: boolean | DocsSearchConfig;
  mcp: DocsMcpResolvedConfig;
  feedback?: DocsAgentFeedbackDiscoveryConfig;
  llms?: DocsLlmsDiscoveryConfig;
  sitemap?: boolean | DocsSitemapConfig;
  robots?: boolean | DocsRobotsConfig;
  openapi?: boolean | DocsOpenApiDiscoveryConfig;
  markdown?: {
    acceptHeader?: boolean;
    signatureAgentHeader?: boolean;
  };
}
interface DocsSkillDocumentOptions {
  origin: string;
  entry?: string;
  search?: boolean | DocsSearchConfig;
  mcp: DocsMcpResolvedConfig;
  feedback?: DocsAgentFeedbackDiscoveryConfig;
  llms?: DocsLlmsDiscoveryConfig;
  sitemap?: boolean | DocsSitemapConfig;
  robots?: boolean | DocsRobotsConfig;
  openapi?: boolean | DocsOpenApiDiscoveryConfig;
  markdown?: {
    acceptHeader?: boolean;
    signatureAgentHeader?: boolean;
  };
}
interface DocsAgentsDocumentOptions extends DocsSkillDocumentOptions {}
interface DocsMarkdownPage {
  slug?: string;
  url: string;
  title: string;
  description?: string;
  lastModified?: string;
  lastmod?: string;
  related?: ResolvedDocsRelatedLink[];
  content: string;
  rawContent?: string;
  agentContent?: string;
  agentRawContent?: string;
  agentFallbackContent?: string;
  agentFallbackRawContent?: string;
}
interface DocsMarkdownDocumentOptions {
  llms?: boolean | DocsLlmsDiscoveryConfig | LlmsTxtConfig;
  origin?: string;
  sitemap?: boolean | DocsSitemapConfig;
}
interface DocsMarkdownNotFoundOptions {
  entry?: string;
  requestedPath: string;
  origin?: string;
  pages?: DocsMarkdownPage[];
  sitemap?: boolean | DocsSitemapConfig;
}
interface DocsMarkdownRecoveryMatch {
  title: string;
  url: string;
  markdownUrl: string;
  description?: string;
  confidence: number;
}
interface DocsMarkdownRecoveryResult {
  matches: DocsMarkdownRecoveryMatch[];
  redirect?: DocsMarkdownRecoveryMatch;
}
interface DocsMarkdownCanonicalUrlOptions {
  origin: string;
  entry?: string;
  requestedPath: string;
  locale?: string | null;
}
declare function normalizeDocsPathSegment(value: string): string;
declare function normalizeDocsUrlPath(value: string): string;
declare function buildDocsAgentFeedbackSchema(payloadSchema: Record<string, unknown>): Record<string, unknown>;
declare function resolveDocsAgentFeedbackConfig(feedback?: boolean | FeedbackConfig): DocsAgentFeedbackResolvedConfig;
declare function resolveDocsAgentFeedbackRequest(url: URL, feedback: DocsAgentFeedbackResolvedConfig): DocsAgentFeedbackRequest | null;
declare function parseDocsAgentFeedbackData(request: Request): Promise<{
  ok: true;
  data: DocsAgentFeedbackData;
} | {
  ok: false;
  response: Response;
}>;
declare function validateDocsAgentFeedbackPayload(value: unknown, schema: Record<string, unknown>, valuePath?: string): string | undefined;
declare function toDocsMarkdownUrl(url: string, options?: {
  locale?: string;
}): string;
declare function resolveDocsMarkdownCanonicalUrl({
  origin,
  entry,
  requestedPath,
  locale
}: DocsMarkdownCanonicalUrlOptions): string;
declare function getDocsMarkdownCanonicalLinkHeader(options: DocsMarkdownCanonicalUrlOptions): string;
declare function resolveDocsLlmsTxtSections(llms?: boolean | DocsLlmsDiscoveryConfig | LlmsTxtConfig): DocsLlmsTxtResolvedSection[];
declare function matchesDocsLlmsTxtSection(pageUrl: string, section: DocsLlmsTxtResolvedSection): boolean;
declare function resolveDocsLlmsTxtRequest(url: URL, llms?: boolean | DocsLlmsDiscoveryConfig | LlmsTxtConfig, basePath?: string): DocsLlmsTxtRequest | null;
declare function renderDocsLlmsTxt(pages: DocsLlmsTxtPageInput[], options?: DocsLlmsDiscoveryConfig): DocsLlmsTxtGeneratedContent;
declare function selectDocsLlmsTxtContent(content: DocsLlmsTxtGeneratedContent, request: DocsLlmsTxtRequest): DocsLlmsTxtSelectedContent | null;
declare function getDocsLlmsTxtMaxCharsIssue(label: string, content: string, maxChars: DocsLlmsTxtResolvedMaxChars): DocsLlmsTxtMaxCharsIssue | null;
declare function isDocsAgentDiscoveryRequest(url: URL): boolean;
declare function isDocsMcpRequest(url: URL): boolean;
declare function buildDocsMcpEndpointCandidates(baseUrl: string, routes?: readonly string[], options?: DocsMcpEndpointCandidateOptions): DocsMcpEndpointCandidate[];
declare function isDocsSkillRequest(url: URL): boolean;
declare function resolveDocsSkillFormat(url: URL): "skill" | null;
declare function isDocsAgentsRequest(url: URL): boolean;
declare function resolveDocsAgentsFormat(url: URL): "agents" | null;
declare function isDocsPublicGetRequest(entry: string, url: URL, request: Request, options?: {
  sitemap?: boolean | DocsSitemapConfig;
  llms?: boolean | DocsLlmsDiscoveryConfig | LlmsTxtConfig;
  robots?: boolean | DocsRobotsConfig;
}): boolean;
declare function isDocsLlmsTxtPublicRequest(url: URL, llms?: boolean | DocsLlmsDiscoveryConfig | LlmsTxtConfig, basePath?: string): boolean;
declare function resolveDocsLlmsTxtFormat(url: URL, basePath?: string): "llms" | "llms-full" | null;
declare function resolveDocsMarkdownRequest(entry: string, url: URL, request: Request): {
  requestedPath: string;
} | null;
declare function hasDocsMarkdownSignatureAgent(request: Request): boolean;
type DocsMarkdownAgentDetection = {
  detected: true;
  method: "signature_agent" | "user_agent" | "heuristic";
} | {
  detected: false;
  method: null;
};
declare function detectDocsMarkdownAgentRequest(request: Request): DocsMarkdownAgentDetection;
declare function getDocsMarkdownVaryHeader(request: Request): string | null;
declare function resolveDocsMarkdownRecovery({
  entry,
  requestedPath,
  pages
}: DocsMarkdownNotFoundOptions): DocsMarkdownRecoveryResult;
declare function renderDocsMarkdownNotFound({
  entry,
  requestedPath,
  origin,
  pages,
  sitemap
}: DocsMarkdownNotFoundOptions): string;
declare function findDocsMarkdownPage<T extends DocsMarkdownPage>(entry: string, pages: T[], requestedPath: string): T | null;
declare function renderDocsMarkdownDocument(page: DocsMcpPage | DocsSearchSourcePage, options?: DocsMarkdownDocumentOptions): string;
declare function renderDocsMarkdownDocument(page: DocsMarkdownPage, options?: DocsMarkdownDocumentOptions): string;
declare function renderDocsSkillDocument(options: DocsSkillDocumentOptions): string;
declare function renderDocsAgentsDocument(options: DocsAgentsDocumentOptions): string;
declare function resolveDocsAgentMdxContent(content: string, audience: "human" | "agent"): string;
declare function buildDocsAgentDiscoverySpec({
  origin,
  entry,
  i18n,
  search,
  mcp,
  feedback,
  llms,
  sitemap,
  robots,
  openapi,
  markdown
}: DocsAgentDiscoverySpecOptions): {
  version: string;
  name: string;
  baseUrl: string;
  site: {
    title: string;
    description: string | undefined;
    entry: string;
    baseUrl: string;
  };
  locales: {
    enabled: boolean;
    available: string[];
    default: string | null;
    queryParam: string;
    fallbackQueryParam: string;
  };
  capabilities: {
    markdownRoutes: boolean;
    agentMdOverrides: boolean;
    agentBlocks: boolean;
    agents: boolean;
    llms: boolean;
    skills: boolean;
    mcp: boolean;
    search: boolean;
    sitemap: boolean;
    robots: boolean;
    structuredData: boolean;
    apiReference: boolean;
    openapi: boolean;
    agentFeedback: boolean;
    locales: boolean;
  };
  api: {
    docs: string;
    agentSpec: string;
    agentSpecDefault: string;
    agentSpecFallback: string;
    agentSpecWellKnown: string;
    agentSpecWellKnownJson: string;
    agentSpecQuery: string;
    agents: string;
    openapi: string;
  };
  markdown: {
    enabled: boolean;
    acceptHeader: string | null;
    signatureAgentHeader: string | null;
    pagePattern: string;
    rootPage: string;
    apiPattern: string;
    resolutionOrder: string[];
  };
  llms: {
    sections?: {
      title: string;
      description: string | undefined;
      match: string[];
      txt: string;
      full: string;
    }[] | undefined;
    enabled: boolean;
    defaultTxt: string;
    defaultFull: string;
    txt: string;
    full: string;
    publicTxt: string;
    publicFull: string;
    wellKnownTxt: string;
    wellKnownFull: string;
  };
  sitemap: {
    enabled: boolean;
    xml: {
      enabled: boolean;
      route: string;
      api: string;
      defaultRoute: string;
    };
    markdown: {
      enabled: boolean;
      route: string;
      docsRoute: string | undefined;
      wellKnownRoute: string;
      api: string;
      defaultRoute: string;
      defaultDocsRoute: string;
      defaultWellKnownRoute: string;
    };
  };
  robots: {
    enabled: boolean;
    route: string;
    defaultRoute: string;
  };
  structuredData: {
    enabled: boolean;
    format: string;
    schema: string;
    fields: string[];
    canonicalUrlField: string;
    breadcrumbType: string;
  };
  openapi: {
    enabled: boolean;
    url: string | null;
    source: "generated" | "configured" | null;
    specUrl: string | null;
    apiReferencePath: string | null;
    format: string;
  };
  search: {
    enabled: boolean;
    endpoint: string;
    method: string;
    queryParam: string;
    localeParam: string;
  };
  agents: {
    enabled: boolean;
    file: string;
    route: string;
    wellKnown: string;
    api: string;
    generatedFallback: boolean;
    aliases: string[];
  };
  skills: {
    enabled: boolean;
    file: string;
    route: string;
    wellKnown: string;
    api: string;
    generatedFallback: boolean;
    registry: string;
    install: string;
    recommended: {
      name: string;
      description: string;
    }[];
  };
  mcp: {
    enabled: boolean;
    endpoint: string;
    defaultEndpoint: string;
    publicEndpoint: string;
    wellKnownEndpoint: string;
    publicEndpoints: string[];
    canonicalEndpoint: string;
    name: string;
    version: string;
    tools: {
      listDocs: boolean;
      listPages: boolean;
      readPage: boolean;
      searchDocs: boolean;
      getNavigation: boolean;
      getCodeExamples: boolean;
      getConfigSchema: boolean;
    };
  };
  feedback: {
    enabled: boolean;
    schema: string;
    submit: string;
    schemaQuery: string;
    submitQuery: string;
  };
  instructions: {
    preferMarkdownRoutes: boolean;
    useMcpWhenAvailable: boolean;
    useOpenApiWhenAvailable: boolean;
    readFeedbackSchemaBeforeSubmitting: boolean;
    doNotAssumeFeedbackPayloadShape: boolean;
  };
};
declare function resolveDocsOpenApiDiscoveryConfig(openapi?: boolean | DocsOpenApiDiscoveryConfig): DocsOpenApiResolvedDiscoveryConfig;
//#endregion
//#region src/robots.d.ts
declare const DEFAULT_ROBOTS_TXT_ROUTE = "/robots.txt";
declare const DOCS_ROBOTS_GENERATED_BLOCK_START = "# BEGIN @farming-labs/docs robots";
declare const DOCS_ROBOTS_GENERATED_BLOCK_END = "# END @farming-labs/docs robots";
declare const DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS: readonly ["GPTBot", "ChatGPT-User", "OAI-SearchBot", "ClaudeBot", "Claude-User", "anthropic-ai", "CCBot", "Google-Extended"];
interface DocsRobotsResolvedConfig {
  enabled: boolean;
  path?: string;
  baseUrl?: string;
  ai: "allow" | "disallow";
  userAgents: string[];
  extraRules: DocsRobotsRule[];
}
interface DocsRobotsRenderOptions {
  entry?: string;
  sitemap?: boolean | DocsSitemapConfig;
  baseUrl?: string;
  robots?: boolean | DocsRobotsConfig;
}
interface DocsRobotsAnalysis {
  blocksAgentRoutes: boolean;
  blocksAiAgents: boolean;
  hasAgentRoutes: boolean;
  hasAiPolicy: boolean;
  missingRoutes: string[];
}
interface CreateDocsRobotsResponseOptions extends DocsRobotsRenderOptions {
  request: Request;
}
declare function resolveDocsRobotsConfig(input: boolean | DocsRobotsConfig | undefined, options?: {
  baseUrl?: string;
}): DocsRobotsResolvedConfig;
declare function getDocsRobotsAllowRoutes(options?: DocsRobotsRenderOptions): string[];
declare function renderDocsRobotsTxt(options?: DocsRobotsRenderOptions): string;
declare function resolveDocsRobotsRequest(url: URL, robots?: boolean | DocsRobotsConfig): "robots" | null;
declare function createDocsRobotsResponse({
  request,
  ...options
}: CreateDocsRobotsResponseOptions): Response | null;
declare function renderDocsRobotsGeneratedBlock(options?: DocsRobotsRenderOptions): string;
declare function upsertDocsRobotsGeneratedBlock(existing: string, block: string): string;
declare function analyzeDocsRobotsTxt(content: string, options?: DocsRobotsRenderOptions): DocsRobotsAnalysis;
//#endregion
export { type AIConfig, type AgentFeedbackConfig, type AlgoliaDocsSearchConfig, type ApiReferenceConfig, type ApiReferenceRenderer, type BreadcrumbConfig, type ChangelogConfig, type ChangelogEntrySummary, type ChangelogFrontmatter, type CodeBlockCopyData, type CopyMarkdownConfig, type CustomDocsSearchConfig, DEFAULT_AGENTS_MD_ROUTE, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA, DEFAULT_AGENT_FEEDBACK_ROUTE, DEFAULT_AGENT_MD_ROUTE, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, DEFAULT_AGENT_SPEC_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS, DEFAULT_DOCS_API_ROUTE, DEFAULT_LLMS_FULL_TXT_ROUTE, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, DEFAULT_LLMS_TXT_MAX_CHARS, DEFAULT_LLMS_TXT_ROUTE, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, DEFAULT_MCP_PUBLIC_ROUTE, DEFAULT_MCP_ROUTE, DEFAULT_MCP_WELL_KNOWN_ROUTE, DEFAULT_OPENAPI_SCHEMA_ROUTE, DEFAULT_ROBOTS_TXT_ROUTE, DEFAULT_SITEMAP_MANIFEST_PATH, DEFAULT_SITEMAP_MD_DOCS_ROUTE, DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, DEFAULT_SKILL_MD_ROUTE, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, DOCS_AGENT_TRACE_EVENT_TYPES, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER, DOCS_ROBOTS_GENERATED_BLOCK_END, DOCS_ROBOTS_GENERATED_BLOCK_START, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN, type DocsAgentDiscoverySpecOptions, type DocsAgentFeedbackContext, type DocsAgentFeedbackData, type DocsAgentFeedbackDiscoveryConfig, type DocsAgentFeedbackRequest, type DocsAgentFeedbackResolvedConfig, type DocsAgentTraceContext, type DocsAgentTraceEventInput, type DocsAgentTraceEventType, type DocsAgentTraceStatus, type DocsAgentsDocumentOptions, type DocsAnalyticsConfig, type DocsAnalyticsEvent, type DocsAnalyticsEventInput, type DocsAnalyticsEventType, type DocsAnalyticsInput, type DocsAnalyticsSource, type DocsAskAIActionData, type DocsAskAIActionType, type DocsAskAIFeedbackConfig, type DocsAskAIFeedbackData, type DocsAskAIFeedbackMessage, type DocsAskAIFeedbackValue, type DocsAskAIMcpConfig, type DocsCloudApiKeyConfig, type DocsCloudConfig, type DocsCloudFeatureConfig, type DocsCloudPreviewConfig, type DocsCloudPublishConfig, type DocsCodeBlocksConfig, type DocsCodeBlocksPlannerConfig, type DocsCodeBlocksPlannerProvider, type DocsCodeBlocksRunnerConfig, type DocsCodeBlocksRunnerProvider, type DocsCodeBlocksValidateConfig, type DocsCodeBlocksValidationMode, type DocsCodeBlocksValidationPolicy, type DocsConfig, type DocsFeedbackData, type DocsFeedbackValue, type DocsI18nConfig, type DocsLlmsDiscoveryConfig, type DocsLlmsTxtGeneratedContent, type DocsLlmsTxtGeneratedSection, type DocsLlmsTxtMaxCharsIssue, type DocsLlmsTxtPageInput, type DocsLlmsTxtRequest, type DocsLlmsTxtResolvedMaxChars, type DocsLlmsTxtResolvedSection, type DocsLlmsTxtSelectedContent, type DocsMarkdownAgentDetection, type DocsMarkdownPage, type DocsMarkdownRecoveryMatch, type DocsMarkdownRecoveryResult, type DocsMcpConfig, type DocsMcpEndpointCandidate, type DocsMcpEndpointCandidateOptions, type DocsMcpToolsConfig, type DocsMetadata, type DocsNav, type DocsObservabilityConfig, type DocsObservabilityEvent, type DocsObservabilityEventInput, type DocsOpenApiDiscoveryConfig, type DocsOpenApiResolvedDiscoveryConfig, type DocsPageStructuredDataInput, type DocsPathMatch, type DocsRelatedItem, type DocsReviewCiConfig, type DocsReviewCiMode, type DocsReviewConfig, type DocsReviewRulesConfig, type DocsReviewScoreConfig, type DocsReviewSeverity, type DocsRobotsConfig, type DocsRobotsRenderOptions, type DocsRobotsResolvedConfig, type DocsRobotsRule, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchChunkingConfig, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchEmbeddingsConfig, type DocsSearchQuery, type DocsSearchResult, type DocsSearchResultType, type DocsSearchSourcePage, type DocsSitemapConfig, type DocsSitemapFormat, type DocsSitemapManifest, type DocsSitemapManifestPage, type DocsSitemapPageInput, type DocsSitemapResolvedConfig, type DocsSkillDocumentOptions, type DocsStructuredDataBreadcrumb, type DocsTheme, type FeedbackConfig, type FontStyle, GENERATED_AGENT_PROVENANCE_MARKER, GENERATED_AGENT_PROVENANCE_VERSION, type GeneratedAgentProvenance, type GeneratedAgentSourceKind, type GithubConfig, type LastUpdatedConfig, type LlmsTxtConfig, type LlmsTxtMaxCharsConfig, type LlmsTxtMaxCharsMode, type LlmsTxtSectionConfig, type McpDocsSearchConfig, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, type OpenDocsProviderConfig, type OpenDocsProviderId, type OpenDocsTarget, type OpenGraphImage, type OrderingItem, type PageActionsConfig, type PageFrontmatter, type PageOpenGraph, type PageSidebarFrontmatter, type PageTwitter, type PromptAction, type PromptProviderChoice, type ReadingTimeConfig, type ResolvedChangelogConfig, type ResolvedDocsAnalyticsConfig, type ResolvedDocsI18n, type ResolvedDocsObservabilityConfig, type ResolvedDocsRelatedLink, type SerializeOpenDocsProviderOptions, type SerializedOpenDocsProvider, type SidebarComponentProps, type SidebarConfig, type SidebarFolderIndexBehavior, type SidebarFolderNode, type SidebarNode, type SidebarPageNode, type SidebarTree, type SimpleDocsSearchConfig, type ThemeToggleConfig, type TypesenseDocsSearchConfig, type TypographyConfig, type UIConfig, analyzeDocsRobotsTxt, applySidebarFolderIndexBehavior, buildDocsAgentDiscoverySpec, buildDocsAgentFeedbackSchema, buildDocsAskAIContext, buildDocsMcpEndpointCandidates, buildDocsPageStructuredData, buildDocsSearchDocuments, buildDocsSitemapManifest, buildPageOpenGraph, buildPageTwitter, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsRobotsResponse, createDocsSitemapResponse, createMcpSearchAdapter, createSimpleSearchAdapter, createTheme, createTypesenseSearchAdapter, deepMerge, defineDocs, detectDocsMarkdownAgentRequest, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, estimateReadingTimeMinutes, extendTheme, findDocsMarkdownPage, formatDocsAskAIPackageHints, getDocsLlmsTxtMaxCharsIssue, getDocsMarkdownCanonicalLinkHeader, getDocsMarkdownVaryHeader, getDocsRequestAnalyticsProperties, getDocsRobotsAllowRoutes, hasDocsMarkdownSignatureAgent, hashGeneratedAgentContent, inferDocsAskAIPackageHints, isDocsAgentDiscoveryRequest, isDocsAgentsRequest, isDocsLlmsTxtPublicRequest, isDocsMcpRequest, isDocsPublicGetRequest, isDocsSkillRequest, matchesDocsLlmsTxtSection, normalizeDocsPathSegment, normalizeDocsRelated, normalizeDocsUrlPath, normalizeGeneratedAgentContent, parseDocsAgentFeedbackData, parseGeneratedAgentDocument, performDocsSearch, readDocsSitemapManifestFromContentMap, renderDocsAgentsDocument, renderDocsLlmsTxt, renderDocsMarkdownDocument, renderDocsMarkdownNotFound, renderDocsPageStructuredDataJson, renderDocsRelatedMarkdownLines, renderDocsRobotsGeneratedBlock, renderDocsRobotsTxt, renderDocsSitemapMarkdown, renderDocsSitemapXml, renderDocsSkillDocument, resolveAskAISearchRequestConfig, resolveChangelogConfig, resolveDocsAgentFeedbackConfig, resolveDocsAgentFeedbackRequest, resolveDocsAgentMdxContent, resolveDocsAgentsFormat, resolveDocsAnalyticsConfig, resolveDocsI18n, resolveDocsLlmsTxtFormat, resolveDocsLlmsTxtRequest, resolveDocsLlmsTxtSections, resolveDocsLocale, resolveDocsMarkdownCanonicalUrl, resolveDocsMarkdownRecovery, resolveDocsMarkdownRequest, resolveDocsMetadataBaseUrl, resolveDocsObservabilityConfig, resolveDocsOpenApiDiscoveryConfig, resolveDocsPath, resolveDocsRobotsConfig, resolveDocsRobotsRequest, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolveDocsSkillFormat, resolveOGImage, resolvePageReadingTime, resolvePageSidebarFolderIndexBehavior, resolveReadingTimeFromContent, resolveReadingTimeFromSource, resolveReadingTimeOptions, resolveSearchRequestConfig, resolveSidebarFolderIndexBehavior, resolveSidebarFolderIndexBehaviorForPath, resolveTitle, selectDocsLlmsTxtContent, serializeGeneratedAgentDocument, stripGeneratedAgentProvenance, toDocsMarkdownUrl, toDocsSitemapMarkdownUrl, upsertDocsRobotsGeneratedBlock, validateDocsAgentFeedbackPayload };