@farming-labs/docs 0.1.40 → 0.1.42

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
 /**