@farming-labs/docs 0.2.60 → 0.2.62

package/dist/sitemap-Cq-Yj_iA.mjs

@@ -1,247 +0,0 @@
-import { Lt as renderDocsSitemapMarkdown, Pt as buildDocsSitemapManifest, Rt as renderDocsSitemapXml, zt as resolveDocsSitemapConfig } from "./agent-BFqyqEnC.mjs";
-import "./search-D57JXQLj.mjs";
-import "./sitemap-server-C1ibVKOy.mjs";
-import "./agent-evals-kJs2Y9xR.mjs";
-import { createFilesystemDocsMcpSource } from "./mcp.mjs";
-import "./code-blocks-qe0T8-xe.mjs";
-import "./server.mjs";
-import { d as readStringProperty, h as resolveDocsContentDir, i as loadDocsConfigModule, l as readNavTitle, m as resolveDocsConfigPath, p as readTopLevelStringProperty, s as readBooleanProperty, t as extractNestedObjectLiteral } from "./config-DASewQ0x.mjs";
-import { t as detectFramework } from "./utils-6UCLxv4B.mjs";
-import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
-import path from "node:path";
-import { execFileSync } from "node:child_process";
-import pc from "picocolors";
-
-//#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.docsRoute,
-			sitemap.markdown.wellKnownRoute
-		]) {
-			if (!route) continue;
-			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, sitemap.md, and docs/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 };