@farming-labs/docs 0.1.39 → 0.1.41

package/dist/config-CyqDp8tD.mjs

@@ -0,0 +1,270 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+
+//#region src/cli/config.ts
+const FILE_EXTS = [
+	"tsx",
+	"ts",
+	"jsx",
+	"js"
+];
+function escapeRegExp(value) {
+	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function createPropertyPattern(key, valuePattern) {
+	return new RegExp(`\\b${escapeRegExp(key)}\\b\\s*:\\s*${valuePattern}`);
+}
+function findBalancedBraceEnd(content, braceStart) {
+	let depth = 0;
+	let stringQuote = null;
+	let escaped = false;
+	let lineComment = false;
+	let blockComment = false;
+	for (let index = braceStart; index < content.length; index += 1) {
+		const char = content[index];
+		const next = content[index + 1];
+		if (lineComment) {
+			if (char === "\n") lineComment = false;
+			continue;
+		}
+		if (blockComment) {
+			if (char === "*" && next === "/") {
+				blockComment = false;
+				index += 1;
+			}
+			continue;
+		}
+		if (stringQuote) {
+			if (escaped) {
+				escaped = false;
+				continue;
+			}
+			if (char === "\\") {
+				escaped = true;
+				continue;
+			}
+			if (char === stringQuote) stringQuote = null;
+			continue;
+		}
+		if (char === "/" && next === "/") {
+			lineComment = true;
+			index += 1;
+			continue;
+		}
+		if (char === "/" && next === "*") {
+			blockComment = true;
+			index += 1;
+			continue;
+		}
+		if (char === "\"" || char === "'" || char === "`") {
+			stringQuote = char;
+			continue;
+		}
+		if (char === "{") {
+			depth += 1;
+			continue;
+		}
+		if (char !== "}") continue;
+		depth -= 1;
+		if (depth === 0) return index;
+	}
+	return -1;
+}
+function resolveDocsConfigPath(rootDir, explicitPath) {
+	if (explicitPath) {
+		const resolvedPath = resolve(rootDir, explicitPath);
+		if (!existsSync(resolvedPath)) throw new Error(`Could not find docs config at ${explicitPath}.`);
+		return resolvedPath;
+	}
+	for (const ext of FILE_EXTS) {
+		const configPath = join(rootDir, `docs.config.${ext}`);
+		if (existsSync(configPath)) return configPath;
+	}
+	throw new Error("Could not find docs.config.ts or docs.config.tsx in the current project. Use --config to point at a custom path.");
+}
+function readStringProperty(content, key) {
+	return content.match(createPropertyPattern(key, `["']([^"']+)["']`))?.[1];
+}
+function readEnvReferenceProperty(content, key) {
+	const patterns = [
+		createPropertyPattern(key, `process\\.env\\.([A-Za-z_$][\\w$]*)`),
+		createPropertyPattern(key, `process\\.env\\[['"]([^"'\\]]+)['"]\\]`),
+		createPropertyPattern(key, `import\\.meta\\.env\\.([A-Za-z_$][\\w$]*)`),
+		createPropertyPattern(key, `import\\.meta\\.env\\[['"]([^"'\\]]+)['"]\\]`)
+	];
+	for (const pattern of patterns) {
+		const match = content.match(pattern);
+		if (match?.[1]) return match[1];
+	}
+}
+function readBooleanProperty(content, key) {
+	const match = content.match(createPropertyPattern(key, "(true|false)"));
+	return match ? match[1] === "true" : void 0;
+}
+function readNumberProperty(content, key) {
+	const match = content.match(createPropertyPattern(key, "(-?\\d+(?:\\.\\d+)?)"));
+	if (!match) return void 0;
+	const parsed = Number.parseFloat(match[1]);
+	return Number.isFinite(parsed) ? parsed : void 0;
+}
+function extractObjectLiteral(content, key) {
+	const keyIndex = content.search(new RegExp(`${key}\\s*:\\s*\\{`));
+	if (keyIndex === -1) return void 0;
+	const braceStart = content.indexOf("{", keyIndex);
+	if (braceStart === -1) return void 0;
+	const braceEnd = findBalancedBraceEnd(content, braceStart);
+	return braceEnd === -1 ? void 0 : content.slice(braceStart + 1, braceEnd);
+}
+function extractTopLevelConfigObject(content) {
+	for (const marker of ["defineDocs(", "export default"]) {
+		const markerIndex = content.indexOf(marker);
+		if (markerIndex === -1) continue;
+		const braceStart = content.indexOf("{", markerIndex);
+		if (braceStart === -1) continue;
+		const braceEnd = findBalancedBraceEnd(content, braceStart);
+		if (braceEnd !== -1) return content.slice(braceStart + 1, braceEnd);
+	}
+}
+function extractNestedObjectLiteral(content, keys) {
+	if (keys.length === 0) return void 0;
+	let current = extractTopLevelConfigObject(content) ?? content;
+	for (const key of keys) {
+		const next = extractObjectLiteral(current, key);
+		if (!next) return void 0;
+		current = next;
+	}
+	return current;
+}
+function splitTopLevelProperties(content) {
+	const properties = [];
+	let start = 0;
+	let stringQuote = null;
+	let escaped = false;
+	let braceDepth = 0;
+	let bracketDepth = 0;
+	let parenDepth = 0;
+	for (let index = 0; index < content.length; index += 1) {
+		const char = content[index];
+		if (stringQuote) {
+			if (escaped) {
+				escaped = false;
+				continue;
+			}
+			if (char === "\\") {
+				escaped = true;
+				continue;
+			}
+			if (char === stringQuote) stringQuote = null;
+			continue;
+		}
+		if (char === "\"" || char === "'" || char === "`") {
+			stringQuote = char;
+			continue;
+		}
+		if (char === "{") {
+			braceDepth += 1;
+			continue;
+		}
+		if (char === "}") {
+			braceDepth = Math.max(0, braceDepth - 1);
+			continue;
+		}
+		if (char === "[") {
+			bracketDepth += 1;
+			continue;
+		}
+		if (char === "]") {
+			bracketDepth = Math.max(0, bracketDepth - 1);
+			continue;
+		}
+		if (char === "(") {
+			parenDepth += 1;
+			continue;
+		}
+		if (char === ")") {
+			parenDepth = Math.max(0, parenDepth - 1);
+			continue;
+		}
+		if (char === "," && braceDepth === 0 && bracketDepth === 0 && parenDepth === 0) {
+			properties.push(content.slice(start, index));
+			start = index + 1;
+		}
+	}
+	const trailing = content.slice(start);
+	if (trailing.trim().length > 0) properties.push(trailing);
+	return properties;
+}
+function readTopLevelStringProperty(content, key) {
+	const source = extractTopLevelConfigObject(content) ?? content;
+	const propertyPattern = new RegExp(`^\\s*${escapeRegExp(key)}\\s*:\\s*["']([^"']+)["']`);
+	for (const property of splitTopLevelProperties(source)) {
+		const match = property.trim().match(propertyPattern);
+		if (match) return match[1];
+	}
+}
+function readNavTitle(content) {
+	const block = extractObjectLiteral(extractTopLevelConfigObject(content) ?? content, "nav");
+	if (!block) return void 0;
+	return readStringProperty(block, "title");
+}
+function resolveDocsContentDir(rootDir, content, entry) {
+	const configuredContentDir = readTopLevelStringProperty(content, "contentDir");
+	if (configuredContentDir) return configuredContentDir;
+	const candidates = [
+		entry,
+		join("app", entry),
+		join("src", "app", entry)
+	];
+	for (const candidate of candidates) if (existsSync(join(rootDir, candidate))) return candidate;
+	return entry;
+}
+function parseEnvValue(rawValue) {
+	const value = rawValue.trim();
+	if (value.startsWith("\"") && value.endsWith("\"") || value.startsWith("'") && value.endsWith("'")) return value.slice(1, -1);
+	return value;
+}
+function loadProjectEnv(rootDir) {
+	const env = {};
+	for (const filename of [".env", ".env.local"]) {
+		const fullPath = join(rootDir, filename);
+		if (!existsSync(fullPath)) continue;
+		const lines = readFileSync(fullPath, "utf-8").split(/\r?\n/);
+		for (const line of lines) {
+			const trimmed = line.trim();
+			if (!trimmed || trimmed.startsWith("#")) continue;
+			const equalsIndex = trimmed.indexOf("=");
+			if (equalsIndex === -1) continue;
+			const key = trimmed.slice(0, equalsIndex).trim();
+			const rawValue = trimmed.slice(equalsIndex + 1);
+			if (!key) continue;
+			env[key] = parseEnvValue(rawValue);
+		}
+	}
+	return env;
+}
+async function loadDocsConfigModule(rootDir, explicitPath) {
+	const configPath = resolveDocsConfigPath(rootDir, explicitPath);
+	try {
+		const { createJiti } = await import("jiti");
+		const loaded = await createJiti(import.meta.url, {
+			moduleCache: false,
+			fsCache: false,
+			interopDefault: true
+		}).import(configPath);
+		const config = loaded.default ?? loaded;
+		if (!config || typeof config !== "object") return null;
+		return {
+			path: configPath,
+			config
+		};
+	} catch (error) {
+		if (process.env.NODE_ENV !== "test") {
+			const message = error instanceof Error ? error.message : String(error);
+			console.warn(`[docs] Could not evaluate ${configPath} as a module; falling back to static parsing. ${message}`);
+		}
+		return null;
+	}
+}
+
+//#endregion
+export { readBooleanProperty as a, readNumberProperty as c, resolveDocsConfigPath as d, resolveDocsContentDir as f, loadProjectEnv as i, readStringProperty as l, extractObjectLiteral as n, readEnvReferenceProperty as o, loadDocsConfigModule as r, readNavTitle as s, extractNestedObjectLiteral as t, readTopLevelStringProperty as u };

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { $ as SidebarFolderNode, A as DocsSearchQuery, B as McpDocsSearchConfig, C as DocsSearchAdapter, D as DocsSearchConfig, E as DocsSearchChunkingConfig, F as FeedbackConfig, G as OrderingItem, H as OpenDocsConfig, I as FontStyle, J as PageOpenGraph, K as PageActionsConfig, L as GithubConfig, M as DocsSearchResultType, N as DocsSearchSourcePage, O as DocsSearchDocument, P as DocsTheme, Q as SidebarConfig, R as LastUpdatedConfig, S as DocsRelatedItem, T as DocsSearchAdapterFactory, U as OpenDocsProvider, V as OGConfig, W as OpenGraphImage, X as ResolvedDocsRelatedLink, Y as PageTwitter, Z as SidebarComponentProps, _ as DocsI18nConfig, a as ApiReferenceRenderer, at as TypesenseDocsSearchConfig, b as DocsMetadata, c as ChangelogFrontmatter, d as CustomDocsSearchConfig, et as SidebarNode, f as DocsAgentFeedbackContext, g as DocsFeedbackValue, h as DocsFeedbackData, i as ApiReferenceConfig, it as ThemeToggleConfig, j as DocsSearchResult, k as DocsSearchEmbeddingsConfig, l as CodeBlockCopyData, m as DocsConfig, n as AgentFeedbackConfig, nt as SidebarTree, o as BreadcrumbConfig, ot as TypographyConfig, p as DocsAgentFeedbackData, q as PageFrontmatter, r as AlgoliaDocsSearchConfig, rt as SimpleDocsSearchConfig, s as ChangelogConfig, st as UIConfig, t as AIConfig, tt as SidebarPageNode, u as CopyMarkdownConfig, v as DocsMcpConfig, w as DocsSearchAdapterContext, x as DocsNav, y as DocsMcpToolsConfig, z as LlmsTxtConfig } from "./types-CP2NmW5c.mjs";
+import { $ as SidebarFolderNode, A as DocsSearchQuery, B as McpDocsSearchConfig, C as DocsSearchAdapter, D as DocsSearchConfig, E as DocsSearchChunkingConfig, F as FeedbackConfig, G as OrderingItem, H as OpenDocsConfig, I as FontStyle, J as PageOpenGraph, K as PageActionsConfig, L as GithubConfig, M as DocsSearchResultType, N as DocsSearchSourcePage, O as DocsSearchDocument, P as DocsTheme, Q as SidebarConfig, R as LastUpdatedConfig, S as DocsRelatedItem, T as DocsSearchAdapterFactory, U as OpenDocsProvider, V as OGConfig, W as OpenGraphImage, X as ResolvedDocsRelatedLink, Y as PageTwitter, Z as SidebarComponentProps, _ as DocsI18nConfig, a as ApiReferenceRenderer, at as TypesenseDocsSearchConfig, b as DocsMetadata, c as ChangelogFrontmatter, d as CustomDocsSearchConfig, et as SidebarNode, f as DocsAgentFeedbackContext, g as DocsFeedbackValue, h as DocsFeedbackData, i as ApiReferenceConfig, it as ThemeToggleConfig, j as DocsSearchResult, k as DocsSearchEmbeddingsConfig, l as CodeBlockCopyData, m as DocsConfig, n as AgentFeedbackConfig, nt as SidebarTree, o as BreadcrumbConfig, ot as TypographyConfig, p as DocsAgentFeedbackData, q as PageFrontmatter, r as AlgoliaDocsSearchConfig, rt as SimpleDocsSearchConfig, s as ChangelogConfig, st as UIConfig, t as AIConfig, tt as SidebarPageNode, u as CopyMarkdownConfig, v as DocsMcpConfig, w as DocsSearchAdapterContext, x as DocsNav, y as DocsMcpToolsConfig, z as LlmsTxtConfig } from "./types-CKdSg7n8.mjs";
 import { DocsMcpPage, DocsMcpResolvedConfig } from "./mcp.mjs";
-import { a as createSimpleSearchAdapter, c as resolveSearchRequestConfig, i as createMcpSearchAdapter, n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, r as createCustomSearchAdapter, s as performDocsSearch, t as buildDocsSearchDocuments } from "./search-BWqFW9rt.mjs";
+import { a as createSimpleSearchAdapter, c as resolveSearchRequestConfig, i as createMcpSearchAdapter, n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, r as createCustomSearchAdapter, s as performDocsSearch, t as buildDocsSearchDocuments } from "./search-C15yRNVE.mjs";
 
 //#region src/define-docs.d.ts
 /**
@@ -187,6 +187,7 @@ declare function normalizeDocsUrlPath(value: string): string;
 declare function isDocsAgentDiscoveryRequest(url: URL): boolean;
 declare function isDocsMcpRequest(url: URL): boolean;
 declare function isDocsSkillRequest(url: URL): boolean;
+declare function resolveDocsSkillFormat(url: URL): "skill" | null;
 declare function isDocsPublicGetRequest(entry: string, url: URL, request: Request): boolean;
 declare function resolveDocsLlmsTxtFormat(url: URL): "llms" | "llms-full" | null;
 declare function resolveDocsMarkdownRequest(entry: string, url: URL, request: Request): {
@@ -323,4 +324,4 @@ declare function buildDocsAgentDiscoverySpec({
   };
 };
 //#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_AGENT_FEEDBACK_ROUTE, DEFAULT_AGENT_SPEC_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, DEFAULT_DOCS_API_ROUTE, DEFAULT_LLMS_FULL_TXT_ROUTE, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, DEFAULT_LLMS_TXT_ROUTE, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, DEFAULT_MCP_PUBLIC_ROUTE, DEFAULT_MCP_ROUTE, DEFAULT_MCP_WELL_KNOWN_ROUTE, DEFAULT_SKILL_MD_ROUTE, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, type DocsAgentDiscoverySpecOptions, type DocsAgentFeedbackContext, type DocsAgentFeedbackData, type DocsAgentFeedbackDiscoveryConfig, type DocsConfig, type DocsFeedbackData, type DocsFeedbackValue, type DocsI18nConfig, type DocsLlmsDiscoveryConfig, type DocsMarkdownPage, type DocsMcpConfig, type DocsMcpToolsConfig, type DocsMetadata, type DocsNav, type DocsPathMatch, type DocsRelatedItem, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchChunkingConfig, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchEmbeddingsConfig, type DocsSearchQuery, type DocsSearchResult, type DocsSearchResultType, type DocsSearchSourcePage, type DocsSkillDocumentOptions, type DocsTheme, type FeedbackConfig, type FontStyle, type GithubConfig, type LastUpdatedConfig, type LlmsTxtConfig, type McpDocsSearchConfig, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, type OpenGraphImage, type OrderingItem, type PageActionsConfig, type PageFrontmatter, type PageOpenGraph, type PageTwitter, type ResolvedChangelogConfig, type ResolvedDocsI18n, type ResolvedDocsRelatedLink, type SidebarComponentProps, type SidebarConfig, type SidebarFolderNode, type SidebarNode, type SidebarPageNode, type SidebarTree, type SimpleDocsSearchConfig, type ThemeToggleConfig, type TypesenseDocsSearchConfig, type TypographyConfig, type UIConfig, buildDocsAgentDiscoverySpec, buildDocsSearchDocuments, buildPageOpenGraph, buildPageTwitter, createAlgoliaSearchAdapter, createCustomSearchAdapter, createMcpSearchAdapter, createSimpleSearchAdapter, createTheme, createTypesenseSearchAdapter, deepMerge, defineDocs, extendTheme, findDocsMarkdownPage, isDocsAgentDiscoveryRequest, isDocsMcpRequest, isDocsPublicGetRequest, isDocsSkillRequest, normalizeDocsPathSegment, normalizeDocsRelated, normalizeDocsUrlPath, performDocsSearch, renderDocsMarkdownDocument, renderDocsRelatedMarkdownLines, renderDocsSkillDocument, resolveChangelogConfig, resolveDocsAgentMdxContent, resolveDocsI18n, resolveDocsLlmsTxtFormat, resolveDocsLocale, resolveDocsMarkdownRequest, resolveDocsPath, resolveOGImage, resolveSearchRequestConfig, resolveTitle };
+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_AGENT_FEEDBACK_ROUTE, DEFAULT_AGENT_SPEC_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, DEFAULT_DOCS_API_ROUTE, DEFAULT_LLMS_FULL_TXT_ROUTE, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, DEFAULT_LLMS_TXT_ROUTE, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, DEFAULT_MCP_PUBLIC_ROUTE, DEFAULT_MCP_ROUTE, DEFAULT_MCP_WELL_KNOWN_ROUTE, DEFAULT_SKILL_MD_ROUTE, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, type DocsAgentDiscoverySpecOptions, type DocsAgentFeedbackContext, type DocsAgentFeedbackData, type DocsAgentFeedbackDiscoveryConfig, type DocsConfig, type DocsFeedbackData, type DocsFeedbackValue, type DocsI18nConfig, type DocsLlmsDiscoveryConfig, type DocsMarkdownPage, type DocsMcpConfig, type DocsMcpToolsConfig, type DocsMetadata, type DocsNav, type DocsPathMatch, type DocsRelatedItem, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchChunkingConfig, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchEmbeddingsConfig, type DocsSearchQuery, type DocsSearchResult, type DocsSearchResultType, type DocsSearchSourcePage, type DocsSkillDocumentOptions, type DocsTheme, type FeedbackConfig, type FontStyle, type GithubConfig, type LastUpdatedConfig, type LlmsTxtConfig, type McpDocsSearchConfig, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, type OpenGraphImage, type OrderingItem, type PageActionsConfig, type PageFrontmatter, type PageOpenGraph, type PageTwitter, type ResolvedChangelogConfig, type ResolvedDocsI18n, type ResolvedDocsRelatedLink, type SidebarComponentProps, type SidebarConfig, type SidebarFolderNode, type SidebarNode, type SidebarPageNode, type SidebarTree, type SimpleDocsSearchConfig, type ThemeToggleConfig, type TypesenseDocsSearchConfig, type TypographyConfig, type UIConfig, buildDocsAgentDiscoverySpec, buildDocsSearchDocuments, buildPageOpenGraph, buildPageTwitter, createAlgoliaSearchAdapter, createCustomSearchAdapter, createMcpSearchAdapter, createSimpleSearchAdapter, createTheme, createTypesenseSearchAdapter, deepMerge, defineDocs, extendTheme, findDocsMarkdownPage, isDocsAgentDiscoveryRequest, isDocsMcpRequest, isDocsPublicGetRequest, isDocsSkillRequest, normalizeDocsPathSegment, normalizeDocsRelated, normalizeDocsUrlPath, performDocsSearch, renderDocsMarkdownDocument, renderDocsRelatedMarkdownLines, renderDocsSkillDocument, resolveChangelogConfig, resolveDocsAgentMdxContent, resolveDocsI18n, resolveDocsLlmsTxtFormat, resolveDocsLocale, resolveDocsMarkdownRequest, resolveDocsPath, resolveDocsSkillFormat, resolveOGImage, resolveSearchRequestConfig, resolveTitle };