@farming-labs/docs 0.1.73 → 0.1.75

package/dist/sitemap-DCR8tuA7.mjs

@@ -0,0 +1,240 @@
+import "./search-kP0mAXCp.mjs";
+import { a as buildDocsSitemapManifest, c as renderDocsSitemapMarkdown, l as renderDocsSitemapXml, u as resolveDocsSitemapConfig } from "./sitemap-Buobvabq.mjs";
+import "./sitemap-server-B370zkEo.mjs";
+import { createFilesystemDocsMcpSource } from "./mcp.mjs";
+import "./server.mjs";
+import { c as readNavTitle, d as readTopLevelStringProperty, f as resolveDocsConfigPath, i as loadDocsConfigModule, o as readBooleanProperty, p as resolveDocsContentDir, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-C7sUsMkm.mjs";
+import { t as detectFramework } from "./utils-l0lcezN8.mjs";
+import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import path from "node:path";
+import pc from "picocolors";
+import { execFileSync } from "node:child_process";
+
+//#region src/cli/sitemap.ts
+function normalizePathSegment(value) {
+	return value.replace(/^\/+|\/+$/g, "");
+}
+function parseInlineFlag(arg) {
+	const [rawKey, value] = arg.slice(2).split("=", 2);
+	return {
+		key: rawKey.trim(),
+		value
+	};
+}
+function parseSitemapGenerateArgs(argv) {
+	const parsed = {};
+	for (let index = 0; index < argv.length; index += 1) {
+		const arg = argv[index];
+		if (arg === "--help" || arg === "-h") {
+			parsed.help = true;
+			continue;
+		}
+		if (arg === "--public") {
+			parsed.public = true;
+			continue;
+		}
+		if (arg === "--manifest-only") {
+			parsed.manifestOnly = true;
+			continue;
+		}
+		if (arg === "--check") {
+			parsed.check = true;
+			continue;
+		}
+		if (arg.startsWith("--config=")) {
+			const value = parseInlineFlag(arg).value;
+			if (!value) throw new Error("Missing value for --config.");
+			parsed.configPath = value;
+			continue;
+		}
+		if (arg === "--config") {
+			const value = argv[index + 1];
+			if (!value || value.startsWith("--")) throw new Error("Missing value for --config.");
+			parsed.configPath = value;
+			index += 1;
+			continue;
+		}
+		throw new Error(`Unknown sitemap generate flag: ${arg}.`);
+	}
+	return parsed;
+}
+function readLlmsBaseUrlFromConfig(content, config) {
+	if (config?.llmsTxt && typeof config.llmsTxt === "object") return config.llmsTxt.baseUrl;
+	const block = extractNestedObjectLiteral(content, ["llmsTxt"]);
+	return block ? readStringProperty(block, "baseUrl") : void 0;
+}
+function readSitemapConfigFromStatic(content) {
+	if (/\bsitemap\s*:\s*false/.test(content)) return false;
+	if (/\bsitemap\s*:\s*true/.test(content)) return true;
+	const block = extractNestedObjectLiteral(content, ["sitemap"]);
+	if (!block) return void 0;
+	return {
+		enabled: readBooleanProperty(block, "enabled") ?? true,
+		routePrefix: readStringProperty(block, "routePrefix"),
+		baseUrl: readStringProperty(block, "baseUrl"),
+		manifestPath: readStringProperty(block, "manifestPath")
+	};
+}
+function resolveConfiguredSitemap(content, config) {
+	if (config?.sitemap !== void 0) return config.sitemap;
+	return readSitemapConfigFromStatic(content) ?? true;
+}
+function formatDateOnly(value) {
+	const parsed = new Date(value);
+	if (Number.isNaN(parsed.getTime())) return void 0;
+	return parsed.toISOString().slice(0, 10);
+}
+function gitLastCommitDate(rootDir, sourcePath) {
+	if (!sourcePath) return void 0;
+	try {
+		return formatDateOnly(execFileSync("git", [
+			"log",
+			"-1",
+			"--format=%cI",
+			"--",
+			sourcePath
+		], {
+			cwd: rootDir,
+			encoding: "utf-8",
+			stdio: [
+				"ignore",
+				"pipe",
+				"ignore"
+			]
+		}).trim());
+	} catch {
+		return;
+	}
+}
+function fileModifiedDate(rootDir, sourcePath) {
+	if (!sourcePath) return void 0;
+	const fullPath = path.isAbsolute(sourcePath) ? sourcePath : path.join(rootDir, sourcePath);
+	if (!existsSync(fullPath)) return void 0;
+	try {
+		return statSync(fullPath).mtime.toISOString().slice(0, 10);
+	} catch {
+		return;
+	}
+}
+function writeIfChanged(filePath, content, check) {
+	if ((existsSync(filePath) ? readFileSync(filePath, "utf-8") : void 0) === content) return false;
+	if (check) return true;
+	mkdirSync(path.dirname(filePath), { recursive: true });
+	writeFileSync(filePath, content, "utf-8");
+	return true;
+}
+function readExistingManifest(filePath) {
+	if (!existsSync(filePath)) return void 0;
+	try {
+		return JSON.parse(readFileSync(filePath, "utf-8"));
+	} catch {
+		return;
+	}
+}
+function comparableManifest(manifest) {
+	return {
+		...manifest,
+		generatedAt: ""
+	};
+}
+function preserveGeneratedAtWhenUnchanged(manifest, existing) {
+	if (!existing?.generatedAt) return manifest;
+	if (JSON.stringify(comparableManifest(manifest)) !== JSON.stringify(comparableManifest(existing))) return manifest;
+	return {
+		...manifest,
+		generatedAt: existing.generatedAt
+	};
+}
+function resolvePublicDir(rootDir) {
+	if (detectFramework(rootDir) === "sveltekit") return path.join(rootDir, "static");
+	return path.join(rootDir, "public");
+}
+function publicFilePath(rootDir, route) {
+	return path.join(resolvePublicDir(rootDir), route.replace(/^\/+/, ""));
+}
+async function generateSitemap(options = {}) {
+	const rootDir = process.cwd();
+	const loadedConfigModule = await loadDocsConfigModule(rootDir, options.configPath);
+	const configContent = readFileSync(loadedConfigModule?.path ?? resolveDocsConfigPath(rootDir, options.configPath), "utf-8");
+	const config = loadedConfigModule?.config;
+	const entry = normalizePathSegment(config?.entry ?? readTopLevelStringProperty(configContent, "entry") ?? "docs") || "docs";
+	const contentDir = typeof config?.contentDir === "string" ? config.contentDir : resolveDocsContentDir(rootDir, configContent, entry);
+	const siteTitle = typeof config?.nav?.title === "string" ? config.nav.title : readNavTitle(configContent) ?? "Documentation";
+	const sitemapInput = resolveConfiguredSitemap(configContent, config);
+	if (sitemapInput === false) throw new Error("Sitemap generation is disabled by `sitemap: false`.");
+	const sitemap = resolveDocsSitemapConfig(sitemapInput, { baseUrl: (typeof sitemapInput === "object" ? sitemapInput.baseUrl : void 0) ?? readLlmsBaseUrlFromConfig(configContent, config) });
+	const source = createFilesystemDocsMcpSource({
+		rootDir,
+		entry,
+		contentDir,
+		siteTitle,
+		ordering: config?.ordering
+	});
+	const pages = await Promise.resolve(source.getPages());
+	if (pages.length === 0) throw new Error(`No docs content was found under ${contentDir}.`);
+	const builtManifest = buildDocsSitemapManifest({
+		pages,
+		entry,
+		siteTitle,
+		baseUrl: sitemap.baseUrl,
+		resolveLastmod(page) {
+			const gitDate = gitLastCommitDate(rootDir, page.sourcePath);
+			if (gitDate) return {
+				lastmod: gitDate,
+				lastmodSource: "git"
+			};
+			const fsDate = fileModifiedDate(rootDir, page.sourcePath);
+			if (fsDate) return {
+				lastmod: fsDate,
+				lastmodSource: "filesystem"
+			};
+		}
+	});
+	const manifestPath = path.resolve(rootDir, sitemap.manifestPath);
+	const manifest = preserveGeneratedAtWhenUnchanged(builtManifest, readExistingManifest(manifestPath));
+	const manifestChanged = writeIfChanged(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, options.check === true);
+	const shouldWritePublic = options.manifestOnly !== true;
+	const publicWrites = [];
+	if (shouldWritePublic) {
+		const xml = renderDocsSitemapXml(manifest, {
+			baseUrl: sitemap.baseUrl,
+			includeLastmod: sitemap.xml.includeLastmod
+		});
+		const markdown = renderDocsSitemapMarkdown(manifest, {
+			baseUrl: sitemap.baseUrl,
+			includeDescriptions: sitemap.markdown.includeDescriptions,
+			includeLastmod: sitemap.markdown.includeLastmod,
+			linkTarget: sitemap.markdown.linkTarget
+		});
+		if (sitemap.xml.enabled) {
+			const filePath = publicFilePath(rootDir, sitemap.xml.route);
+			if (writeIfChanged(filePath, xml, options.check === true)) publicWrites.push(filePath);
+		}
+		if (sitemap.markdown.enabled) for (const route of [sitemap.markdown.route, sitemap.markdown.wellKnownRoute]) {
+			const filePath = publicFilePath(rootDir, route);
+			if (writeIfChanged(filePath, markdown, options.check === true)) publicWrites.push(filePath);
+		}
+	}
+	if (options.check && (manifestChanged || publicWrites.length > 0)) throw new Error("Sitemap output is stale. Run `docs sitemap generate` to update it.");
+	console.log(pc.green(`Generated sitemap manifest for ${manifest.pages.length} page(s).`));
+	console.log(pc.dim(path.relative(rootDir, manifestPath)));
+	for (const filePath of publicWrites) console.log(pc.dim(path.relative(rootDir, filePath)));
+}
+function printSitemapGenerateHelp() {
+	console.log(`
+${pc.bold("docs sitemap generate")} — Generate sitemap metadata and static sitemap files.
+
+${pc.dim("Usage:")}
+  pnpm exec docs ${pc.cyan("sitemap generate")}
+
+${pc.dim("Options:")}
+  ${pc.cyan("--config <path>")}     Use a custom docs config path instead of ${pc.dim("docs.config.ts[x]")}
+  ${pc.cyan("--public")}            Explicitly write public sitemap.xml and sitemap.md files
+  ${pc.cyan("--manifest-only")}     Only write the internal sitemap manifest
+  ${pc.cyan("--check")}             Fail if generated output is stale
+  ${pc.cyan("-h, --help")}          Show this help message
+`);
+}
+
+//#endregion
+export { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp };

package/dist/{prompt-utils-8nmFLQVH.mjs → sitemap-server-B370zkEo.mjs}

@@ -1,6 +1,7 @@
+import { u as resolveDocsSitemapConfig } from "./sitemap-Buobvabq.mjs";
 import { createRequire } from "node:module";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
-import { basename, join, relative } from "node:path";
+import path, { basename, join, relative } from "node:path";
 import { getHtmlDocument } from "@scalar/core/libs/html-rendering";
 
 //#region src/api-reference.ts
@@ -983,4 +984,17 @@ function sanitizePromptText(text) {
 }
 
 //#endregion
-export { sanitizePromptText as a, serializeOpenDocsProviders as c, buildApiReferenceOpenApiDocument as d, buildApiReferenceOpenApiDocumentAsync as f, resolveApiReferenceRenderer as g, resolveApiReferenceConfig as h, resolvePromptProviderChoices as i, buildApiReferenceHtmlDocument as l, buildApiReferenceScalarCss as m, normalizePromptProviderName as n, serializeDocsIcon as o, buildApiReferencePageTitle as p, parsePromptStringArray as r, serializeDocsIconRegistry as s, DEFAULT_PROMPT_PROVIDER_TEMPLATES as t, buildApiReferenceHtmlDocumentAsync as u };
+//#region src/sitemap-server.ts
+function readDocsSitemapManifest(rootDir, sitemap) {
+	const resolved = resolveDocsSitemapConfig(sitemap);
+	const manifestPath = path.resolve(rootDir, resolved.manifestPath);
+	if (!existsSync(manifestPath)) return null;
+	try {
+		return JSON.parse(readFileSync(manifestPath, "utf-8"));
+	} catch {
+		return null;
+	}
+}
+
+//#endregion
+export { resolveApiReferenceRenderer as _, resolvePromptProviderChoices as a, serializeDocsIconRegistry as c, buildApiReferenceHtmlDocumentAsync as d, buildApiReferenceOpenApiDocument as f, resolveApiReferenceConfig as g, buildApiReferenceScalarCss as h, parsePromptStringArray as i, serializeOpenDocsProviders as l, buildApiReferencePageTitle as m, DEFAULT_PROMPT_PROVIDER_TEMPLATES as n, sanitizePromptText as o, buildApiReferenceOpenApiDocumentAsync as p, normalizePromptProviderName as r, serializeDocsIcon as s, readDocsSitemapManifest as t, buildApiReferenceHtmlDocument as u };

package/dist/{templates-BLSQ8EwL.mjs → templates-BlouROIq.mjs}

@@ -847,7 +847,7 @@ export const Route = createFileRoute("${entryUrl}/$")({
     handlers: {
       GET: async ({ request }) => {
         const url = new URL(request.url);
-        if (isDocsPublicGetRequest(${JSON.stringify(opts.entry)}, url, request)) {
+        if (isDocsPublicGetRequest(${JSON.stringify(opts.entry)}, url, request, { sitemap: docsConfig.sitemap })) {
           return docsServer.GET({ request });
         }
         return undefined;
@@ -923,7 +923,7 @@ async function handlePublicDocsRequest(request: Request) {
     });
   }
 
-  if ((method === "GET" || method === "HEAD") && isDocsPublicGetRequest(docsEntry, url, request)) {
+  if ((method === "GET" || method === "HEAD") && isDocsPublicGetRequest(docsEntry, url, request, { sitemap: docsConfig.sitemap })) {
     return docsServer.GET({ request });
   }
 
@@ -1263,7 +1263,7 @@ import { createDocsServer } from "@farming-labs/svelte/server";
 import config from "${svelteServerConfigImport(cfg.useAlias)}";
 
 // preload for production
-const contentFiles = import.meta.glob(["/${cfg.entry ?? "docs"}/**/*.{md,mdx,svx}", "/skill.md"], {
+const contentFiles = import.meta.glob(["/${cfg.entry ?? "docs"}/**/*.{md,mdx,svx}", "/skill.md", "/.farming-labs/sitemap-manifest.json"], {
   query: "?raw",
   import: "default",
   eager: true,
@@ -1342,7 +1342,7 @@ export const handle: Handle = async ({ event, resolve }) => {
     });
   }
 
-  if ((method === "GET" || method === "HEAD") && isDocsPublicGetRequest(docsEntry, event.url, event.request)) {
+  if ((method === "GET" || method === "HEAD") && isDocsPublicGetRequest(docsEntry, event.url, event.request, { sitemap: config.sitemap })) {
     return GET({ url: event.url, request: event.request });
   }
 
@@ -1390,7 +1390,7 @@ const docsPublicHandle: Handle = async ({ event, resolve }) => {
     });
   }
 
-  if ((method === "GET" || method === "HEAD") && isDocsPublicGetRequest(docsEntry, event.url, event.request)) {
+  if ((method === "GET" || method === "HEAD") && isDocsPublicGetRequest(docsEntry, event.url, event.request, { sitemap: config.sitemap })) {
     return docsGET({ url: event.url, request: event.request });
   }
 
@@ -1667,7 +1667,7 @@ function astroDocsServerTemplate(cfg) {
 import { createDocsServer } from "@farming-labs/astro/server";
 import config from "${astroServerConfigImport(cfg.useAlias)}";
 
-const contentFiles = import.meta.glob(["/${cfg.entry ?? "docs"}/**/*.{md,mdx}", "/skill.md"], {
+const contentFiles = import.meta.glob(["/${cfg.entry ?? "docs"}/**/*.{md,mdx}", "/skill.md", "/.farming-labs/sitemap-manifest.json"], {
   query: "?raw",
   import: "default",
   eager: true,
@@ -1806,7 +1806,7 @@ export const onRequest: MiddlewareHandler = async (context, next) => {
     });
   }
 
-  if ((method === "GET" || method === "HEAD") && isDocsPublicGetRequest(docsEntry, context.url, context.request)) {
+  if ((method === "GET" || method === "HEAD") && isDocsPublicGetRequest(docsEntry, context.url, context.request, { sitemap: config.sitemap })) {
     return GET({ request: context.request });
   }
 
@@ -1854,7 +1854,7 @@ const docsPublicMiddleware: MiddlewareHandler = async (context, next) => {
     });
   }
 
-  if ((method === "GET" || method === "HEAD") && isDocsPublicGetRequest(docsEntry, context.url, context.request)) {
+  if ((method === "GET" || method === "HEAD") && isDocsPublicGetRequest(docsEntry, context.url, context.request, { sitemap: config.sitemap })) {
     return docsGET({ request: context.request });
   }
 

package/dist/{types-D-OvczD4.d.mts → types-OAHZJ7NI.d.mts}

@@ -758,6 +758,71 @@ interface LlmsTxtConfig {
    */
   siteDescription?: string;
 }
+interface SitemapXmlConfig {
+  /**
+   * Whether to expose the XML sitemap route.
+   * @default true
+   */
+  enabled?: boolean;
+  /**
+   * Include per-page `<lastmod>` entries when a reliable page date is available.
+   * @default true
+   */
+  includeLastmod?: boolean;
+}
+interface SitemapMarkdownConfig {
+  /**
+   * Whether to expose the Markdown sitemap route.
+   * @default true
+   */
+  enabled?: boolean;
+  /**
+   * Include page descriptions in the Markdown sitemap.
+   * @default true
+   */
+  includeDescriptions?: boolean;
+  /**
+   * Include per-page freshness dates in the Markdown sitemap.
+   * @default true
+   */
+  includeLastmod?: boolean;
+  /**
+   * Which URL each Markdown list item should primarily link to.
+   * @default "both"
+   */
+  linkTarget?: "html" | "markdown" | "both";
+}
+/**
+ * Configuration for generated `/sitemap.xml`, `/sitemap.md`, and
+ * `/.well-known/sitemap.md` routes.
+ */
+interface DocsSitemapConfig {
+  /**
+   * Whether to enable sitemap routes.
+   * @default true when `sitemap` is an object
+   */
+  enabled?: boolean;
+  /**
+   * Optional route prefix. For example, `"/docs"` generates
+   * `/docs/sitemap.xml`, `/docs/sitemap.md`, and `/docs/.well-known/sitemap.md`.
+   * @default ""
+   */
+  routePrefix?: string;
+  /**
+   * Public site URL used to build absolute XML sitemap URLs.
+   * Falls back to the request origin at runtime or llmsTxt.baseUrl in the CLI.
+   */
+  baseUrl?: string;
+  /**
+   * Internal generated manifest path.
+   * @default ".farming-labs/sitemap-manifest.json"
+   */
+  manifestPath?: string;
+  /** XML sitemap options. */
+  xml?: boolean | SitemapXmlConfig;
+  /** Markdown sitemap options. */
+  markdown?: boolean | SitemapMarkdownConfig;
+}
 /**
  * Tool-level toggles for the built-in MCP server.
  *
@@ -808,6 +873,9 @@ interface DocsSearchSourcePage {
   content: string;
   description?: string;
   related?: ResolvedDocsRelatedLink[];
+  sourcePath?: string;
+  lastModified?: string;
+  lastmod?: string;
   rawContent?: string;
   agentContent?: string;
   agentRawContent?: string;
@@ -936,6 +1004,9 @@ interface McpDocsSearchConfig {
   maxResults?: number;
   chunking?: DocsSearchChunkingConfig;
 }
+type DocsAskAIMcpConfig = Omit<McpDocsSearchConfig, "provider"> & {
+  provider?: "mcp";
+};
 interface CustomDocsSearchConfig {
   provider: "custom";
   enabled?: boolean;
@@ -1051,7 +1122,7 @@ interface DocsAskAIFeedbackData {
 }
 interface DocsAskAIFeedbackConfig {
   /**
-   * Whether to show response rating controls after each completed Ask AI answer.
+   * Whether to show the copy, like, and dislike action row after each completed Ask AI answer.
    * @default true
    */
   enabled?: boolean;
@@ -1290,6 +1361,27 @@ interface AIConfig {
    * @default 5
    */
   maxResults?: number;
+  /**
+   * Route Ask AI retrieval through the configured MCP `search_docs` tool.
+   *
+   * - `true` uses the MCP server this docs site already exposes at `mcp.route`
+   *   (default `/api/docs/mcp`)
+   * - an object can point Ask AI at another Streamable HTTP MCP endpoint
+   *
+   * This only affects Ask AI retrieval. The normal docs search API still uses
+   * the top-level `search` config.
+   *
+   * @default false
+   *
+   * @example
+   * ```ts
+   * ai: {
+   *   enabled: true,
+   *   useMcp: true,
+   * }
+   * ```
+   */
+  useMcp?: boolean | DocsAskAIMcpConfig;
   /**
    * Pre-filled suggested questions shown in the AI chat when empty.
    * When a user clicks one, it fills the input and submits automatically.
@@ -1399,10 +1491,10 @@ interface AIConfig {
     name: string;
   }) => unknown;
   /**
-   * Response rating controls for generated Ask AI answers.
+   * Copy, like, and dislike action row for generated Ask AI answers.
    *
-   * Set to `false` to hide the buttons. Pass an object to customize labels
-   * and receive callback payloads with the question, answer, model, and UI surface.
+   * Set to `false` to hide the row. Pass an object to customize rating labels
+   * and receive legacy like/dislike callback payloads.
    *
    * @default true
    *
@@ -2134,6 +2226,20 @@ interface DocsConfig {
    * @see https://llmstxt.org
    */
   llmsTxt?: boolean | LlmsTxtConfig;
+  /**
+   * Generated XML and Markdown sitemaps for crawlers, agents, and static export.
+   *
+   * @example
+   * ```ts
+   * sitemap: true
+   *
+   * sitemap: {
+   *   routePrefix: "/docs",
+   *   baseUrl: "https://docs.example.com",
+   * }
+   * ```
+   */
+  sitemap?: boolean | DocsSitemapConfig;
   /**
    * Generated changelog pages backed by date-folder MDX entries inside the docs
    * content tree.
@@ -2192,4 +2298,4 @@ interface DocsConfig {
   og?: OGConfig;
 }
 //#endregion
-export { FeedbackConfig as $, DocsFeedbackData as A, DocsRelatedItem as B, DocsAskAIActionData as C, SidebarTree as Ct, DocsAskAIFeedbackMessage as D, TypographyConfig as Dt, DocsAskAIFeedbackData as E, TypesenseDocsSearchConfig as Et, DocsMetadata as F, DocsSearchConfig as G, DocsSearchAdapterContext as H, DocsNav as I, DocsSearchQuery as J, DocsSearchDocument as K, DocsObservabilityConfig as L, DocsI18nConfig as M, DocsMcpConfig as N, DocsAskAIFeedbackValue as O, UIConfig as Ot, DocsMcpToolsConfig as P, DocsTheme as Q, DocsObservabilityEvent as R, DocsAnalyticsSource as S, SidebarPageNode as St, DocsAskAIFeedbackConfig as T, ThemeToggleConfig as Tt, DocsSearchAdapterFactory as U, DocsSearchAdapter as V, DocsSearchChunkingConfig as W, DocsSearchResultType as X, DocsSearchResult as Y, DocsSearchSourcePage as Z, DocsAnalyticsConfig as _, SidebarComponentProps as _t, ApiReferenceRenderer as a, OGConfig as at, DocsAnalyticsEventType as b, SidebarFolderNode as bt, ChangelogFrontmatter as c, OpenGraphImage as ct, CustomDocsSearchConfig as d, PageFrontmatter as dt, FontStyle as et, DocsAgentFeedbackContext as f, PageOpenGraph as ft, DocsAgentTraceStatus as g, ResolvedDocsRelatedLink as gt, DocsAgentTraceEventType as h, ReadingTimeConfig as ht, ApiReferenceConfig as i, McpDocsSearchConfig as it, DocsFeedbackValue as j, DocsConfig as k, CodeBlockCopyData as l, OrderingItem as lt, DocsAgentTraceEventInput as m, PageTwitter as mt, AgentFeedbackConfig as n, LastUpdatedConfig as nt, BreadcrumbConfig as o, OpenDocsConfig as ot, DocsAgentFeedbackData as p, PageSidebarFrontmatter as pt, DocsSearchEmbeddingsConfig as q, AlgoliaDocsSearchConfig as r, LlmsTxtConfig as rt, ChangelogConfig as s, OpenDocsProvider as st, AIConfig as t, GithubConfig as tt, CopyMarkdownConfig as u, PageActionsConfig as ut, DocsAnalyticsEvent as v, SidebarConfig as vt, DocsAskAIActionType as w, SimpleDocsSearchConfig as wt, DocsAnalyticsInput as x, SidebarNode as xt, DocsAnalyticsEventInput as y, SidebarFolderIndexBehavior as yt, DocsObservabilityEventInput as z };
+export { DocsSitemapConfig as $, DocsConfig as A, UIConfig as At, DocsObservabilityEventInput as B, DocsAskAIActionData as C, SidebarNode as Ct, DocsAskAIFeedbackMessage as D, ThemeToggleConfig as Dt, DocsAskAIFeedbackData as E, SimpleDocsSearchConfig as Et, DocsMcpToolsConfig as F, DocsSearchChunkingConfig as G, DocsSearchAdapter as H, DocsMetadata as I, DocsSearchEmbeddingsConfig as J, DocsSearchConfig as K, DocsNav as L, DocsFeedbackValue as M, DocsI18nConfig as N, DocsAskAIFeedbackValue as O, TypesenseDocsSearchConfig as Ot, DocsMcpConfig as P, DocsSearchSourcePage as Q, DocsObservabilityConfig as R, DocsAnalyticsSource as S, SidebarFolderNode as St, DocsAskAIFeedbackConfig as T, SidebarTree as Tt, DocsSearchAdapterContext as U, DocsRelatedItem as V, DocsSearchAdapterFactory as W, DocsSearchResult as X, DocsSearchQuery as Y, DocsSearchResultType as Z, DocsAnalyticsConfig as _, ReadingTimeConfig as _t, ApiReferenceRenderer as a, LlmsTxtConfig as at, DocsAnalyticsEventType as b, SidebarConfig as bt, ChangelogFrontmatter as c, OpenDocsConfig as ct, CustomDocsSearchConfig as d, OrderingItem as dt, DocsTheme as et, DocsAgentFeedbackContext as f, PageActionsConfig as ft, DocsAgentTraceStatus as g, PageTwitter as gt, DocsAgentTraceEventType as h, PageSidebarFrontmatter as ht, ApiReferenceConfig as i, LastUpdatedConfig as it, DocsFeedbackData as j, DocsAskAIMcpConfig as k, TypographyConfig as kt, CodeBlockCopyData as l, OpenDocsProvider as lt, DocsAgentTraceEventInput as m, PageOpenGraph as mt, AgentFeedbackConfig as n, FontStyle as nt, BreadcrumbConfig as o, McpDocsSearchConfig as ot, DocsAgentFeedbackData as p, PageFrontmatter as pt, DocsSearchDocument as q, AlgoliaDocsSearchConfig as r, GithubConfig as rt, ChangelogConfig as s, OGConfig as st, AIConfig as t, FeedbackConfig as tt, CopyMarkdownConfig as u, OpenGraphImage as ut, DocsAnalyticsEvent as v, ResolvedDocsRelatedLink as vt, DocsAskAIActionType as w, SidebarPageNode as wt, DocsAnalyticsInput as x, SidebarFolderIndexBehavior as xt, DocsAnalyticsEventInput as y, SidebarComponentProps as yt, DocsObservabilityEvent as z };

package/dist/{upgrade-CA_OE7wL.mjs → upgrade-upRj5Fw-.mjs}

@@ -1,4 +1,4 @@
-import { c as installCommand, i as detectPackageManagerFromLockfile, o as exec, s as fileExists, t as detectFramework } from "./utils-DSMXVnEu.mjs";
+import { c as installCommand, i as detectPackageManagerFromLockfile, o as exec, s as fileExists, t as detectFramework } from "./utils-l0lcezN8.mjs";
 import path from "node:path";
 import pc from "picocolors";
 import * as p from "@clack/prompts";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.1.73",
+  "version": "0.1.75",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",

package/dist/search-DSKaQ2JH.d.mts

@@ -1,88 +0,0 @@
-import { Et as TypesenseDocsSearchConfig, G as DocsSearchConfig, K as DocsSearchDocument, L as DocsObservabilityConfig, R as DocsObservabilityEvent, U as DocsSearchAdapterFactory, V as DocsSearchAdapter, W as DocsSearchChunkingConfig, Y as DocsSearchResult, Z as DocsSearchSourcePage, _ as DocsAnalyticsConfig, d as CustomDocsSearchConfig, it as McpDocsSearchConfig, m as DocsAgentTraceEventInput, r as AlgoliaDocsSearchConfig, v as DocsAnalyticsEvent, y as DocsAnalyticsEventInput, z as DocsObservabilityEventInput } from "./types-D-OvczD4.mjs";
-
-//#region src/cloud-analytics.d.ts
-interface DocsCloudAnalyticsOptions {
-  enabled?: boolean;
-  console?: DocsAnalyticsConfig["console"];
-  includeInputs?: boolean;
-  projectId?: string;
-  apiKey?: string;
-}
-declare function createDocsCloudAnalytics(options?: DocsCloudAnalyticsOptions): DocsAnalyticsConfig;
-//#endregion
-//#region src/analytics.d.ts
-declare const DOCS_AGENT_TRACE_EVENT_TYPES: readonly ["run.start", "run.end", "run.error", "user.input", "prompt.build", "retrieval.query", "retrieval.result", "retrieval.error", "model.call", "model.response", "model.stream", "model.error", "tool.call", "tool.result", "tool.error", "retry", "timeout", "error", "agent.final"];
-interface DocsAgentTraceContext {
-  traceId: string;
-  name: string;
-  startedAt: string;
-  startedMs: number;
-}
-interface ResolvedDocsAnalyticsConfig {
-  enabled: boolean;
-  console: false | "log" | "info" | "debug";
-  includeInputs: boolean;
-  onEvent?: (event: DocsAnalyticsEvent) => void | Promise<void>;
-}
-interface ResolvedDocsObservabilityConfig {
-  enabled: boolean;
-  console: false | "log" | "info" | "debug";
-  includeInputs: boolean;
-  onEvent?: (event: DocsObservabilityEvent) => void | Promise<void>;
-}
-declare function createDocsAgentTraceId(prefix?: string): string;
-declare function createDocsAgentTraceContext(name?: string): DocsAgentTraceContext;
-declare function resolveDocsAnalyticsConfig(analytics?: boolean | DocsAnalyticsConfig): ResolvedDocsAnalyticsConfig;
-declare function resolveDocsObservabilityConfig(observability?: boolean | DocsObservabilityConfig): ResolvedDocsObservabilityConfig;
-declare function emitDocsAnalyticsEvent(analytics: boolean | DocsAnalyticsConfig | undefined, event: DocsAnalyticsEventInput): Promise<void>;
-declare function emitDocsObservabilityEvent(observability: boolean | DocsObservabilityConfig | undefined, event: DocsObservabilityEventInput): Promise<void>;
-declare function emitDocsAgentTraceEvent(observability: boolean | DocsObservabilityConfig | undefined, event: DocsAgentTraceEventInput): Promise<void>;
-//#endregion
-//#region src/search.d.ts
-interface DocsAskAIContextResult extends DocsSearchResult {
-  title: string;
-  contextContent: string;
-}
-interface DocsAskAIContext {
-  context: string;
-  results: DocsAskAIContextResult[];
-  searchResults: DocsSearchResult[];
-  packageHints: DocsAskAIPackageHints;
-}
-interface DocsAskAIPackageHints {
-  packages: string[];
-  imports: string[];
-  installCommands: string[];
-}
-declare function inferDocsAskAIPackageHints(content: string): DocsAskAIPackageHints;
-declare function formatDocsAskAIPackageHints(hints: DocsAskAIPackageHints, packageName?: string): string | undefined;
-declare function buildDocsSearchDocuments(pages: DocsSearchSourcePage[], chunking?: DocsSearchChunkingConfig): DocsSearchDocument[];
-declare function createSimpleSearchAdapter(): DocsSearchAdapter;
-declare function createTypesenseSearchAdapter(config: TypesenseDocsSearchConfig): DocsSearchAdapter;
-declare function resolveSearchRequestConfig(search: boolean | DocsSearchConfig | undefined, requestUrl?: string): boolean | DocsSearchConfig | undefined;
-declare function createMcpSearchAdapter(config: McpDocsSearchConfig): DocsSearchAdapter;
-declare function createAlgoliaSearchAdapter(config: AlgoliaDocsSearchConfig): DocsSearchAdapter;
-declare function performDocsSearch(options: {
-  pages: DocsSearchSourcePage[];
-  query: string;
-  search?: boolean | DocsSearchConfig;
-  locale?: string;
-  pathname?: string;
-  siteTitle?: string;
-  limit?: number;
-}): Promise<DocsSearchResult[]>;
-declare function buildDocsAskAIContext(options: {
-  pages: DocsSearchSourcePage[];
-  query: string;
-  search?: boolean | DocsSearchConfig;
-  locale?: string;
-  pathname?: string;
-  siteTitle?: string;
-  baseUrl?: string;
-  limit?: number;
-  maxContextChars?: number;
-  maxResultChars?: number;
-}): Promise<DocsAskAIContext>;
-declare function createCustomSearchAdapter(adapter: DocsSearchAdapter | DocsSearchAdapterFactory): CustomDocsSearchConfig;
-//#endregion
-export { DocsCloudAnalyticsOptions as C, resolveDocsObservabilityConfig as S, createDocsAgentTraceId as _, createMcpSearchAdapter as a, emitDocsObservabilityEvent as b, formatDocsAskAIPackageHints as c, resolveSearchRequestConfig as d, DOCS_AGENT_TRACE_EVENT_TYPES as f, createDocsAgentTraceContext as g, ResolvedDocsObservabilityConfig as h, createCustomSearchAdapter as i, inferDocsAskAIPackageHints as l, ResolvedDocsAnalyticsConfig as m, buildDocsSearchDocuments as n, createSimpleSearchAdapter as o, DocsAgentTraceContext as p, createAlgoliaSearchAdapter as r, createTypesenseSearchAdapter as s, buildDocsAskAIContext as t, performDocsSearch as u, emitDocsAgentTraceEvent as v, createDocsCloudAnalytics as w, resolveDocsAnalyticsConfig as x, emitDocsAnalyticsEvent as y };