@farming-labs/docs 0.1.74 → 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-OyUzNy83.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;
@@ -2158,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.
@@ -2216,4 +2298,4 @@ interface DocsConfig {
   og?: OGConfig;
 }
 //#endregion
-export { DocsTheme as $, DocsConfig as A, DocsObservabilityEventInput as B, DocsAskAIActionData as C, SidebarPageNode as Ct, DocsAskAIFeedbackMessage as D, TypesenseDocsSearchConfig as Dt, DocsAskAIFeedbackData as E, ThemeToggleConfig 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, TypographyConfig as Ot, DocsMcpConfig as P, DocsSearchSourcePage as Q, DocsObservabilityConfig as R, DocsAnalyticsSource as S, SidebarNode as St, DocsAskAIFeedbackConfig as T, SimpleDocsSearchConfig as Tt, DocsSearchAdapterContext as U, DocsRelatedItem as V, DocsSearchAdapterFactory as W, DocsSearchResult as X, DocsSearchQuery as Y, DocsSearchResultType as Z, DocsAnalyticsConfig as _, ResolvedDocsRelatedLink as _t, ApiReferenceRenderer as a, McpDocsSearchConfig as at, DocsAnalyticsEventType as b, SidebarFolderIndexBehavior as bt, ChangelogFrontmatter as c, OpenDocsProvider as ct, CustomDocsSearchConfig as d, PageActionsConfig as dt, FeedbackConfig as et, DocsAgentFeedbackContext as f, PageFrontmatter as ft, DocsAgentTraceStatus as g, ReadingTimeConfig as gt, DocsAgentTraceEventType as h, PageTwitter as ht, ApiReferenceConfig as i, LlmsTxtConfig as it, DocsFeedbackData as j, DocsAskAIMcpConfig as k, UIConfig as kt, CodeBlockCopyData as l, OpenGraphImage as lt, DocsAgentTraceEventInput as m, PageSidebarFrontmatter as mt, AgentFeedbackConfig as n, GithubConfig as nt, BreadcrumbConfig as o, OGConfig as ot, DocsAgentFeedbackData as p, PageOpenGraph as pt, DocsSearchDocument as q, AlgoliaDocsSearchConfig as r, LastUpdatedConfig as rt, ChangelogConfig as s, OpenDocsConfig as st, AIConfig as t, FontStyle as tt, CopyMarkdownConfig as u, OrderingItem as ut, DocsAnalyticsEvent as v, SidebarComponentProps as vt, DocsAskAIActionType as w, SidebarTree as wt, DocsAnalyticsInput as x, SidebarFolderNode as xt, DocsAnalyticsEventInput as y, SidebarConfig as yt, DocsObservabilityEvent 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.74",
+  "version": "0.1.75",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",

package/dist/search-K4fg0Zzw.d.mts

@@ -1,96 +0,0 @@
-import { B as DocsObservabilityEventInput, Dt as TypesenseDocsSearchConfig, G as DocsSearchChunkingConfig, H as DocsSearchAdapter, K as DocsSearchConfig, Q as DocsSearchSourcePage, R as DocsObservabilityConfig, W as DocsSearchAdapterFactory, X as DocsSearchResult, _ as DocsAnalyticsConfig, at as McpDocsSearchConfig, d as CustomDocsSearchConfig, k as DocsAskAIMcpConfig, m as DocsAgentTraceEventInput, q as DocsSearchDocument, r as AlgoliaDocsSearchConfig, v as DocsAnalyticsEvent, y as DocsAnalyticsEventInput, z as DocsObservabilityEvent } from "./types-OyUzNy83.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 resolveAskAISearchRequestConfig(options: {
-  search: boolean | DocsSearchConfig | undefined;
-  useMcp?: boolean | DocsAskAIMcpConfig;
-  mcpEndpoint?: string;
-  mcpEnabled?: boolean;
-  mcpSearchEnabled?: boolean;
-  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 { resolveDocsObservabilityConfig as C, resolveDocsAnalyticsConfig as S, createDocsCloudAnalytics as T, createDocsAgentTraceContext as _, createMcpSearchAdapter as a, emitDocsAnalyticsEvent as b, formatDocsAskAIPackageHints as c, resolveAskAISearchRequestConfig as d, resolveSearchRequestConfig as f, ResolvedDocsObservabilityConfig as g, ResolvedDocsAnalyticsConfig as h, createCustomSearchAdapter as i, inferDocsAskAIPackageHints as l, DocsAgentTraceContext as m, buildDocsSearchDocuments as n, createSimpleSearchAdapter as o, DOCS_AGENT_TRACE_EVENT_TYPES as p, createAlgoliaSearchAdapter as r, createTypesenseSearchAdapter as s, buildDocsAskAIContext as t, performDocsSearch as u, createDocsAgentTraceId as v, DocsCloudAnalyticsOptions as w, emitDocsObservabilityEvent as x, emitDocsAgentTraceEvent as y };