lildocs 0.1.17 → 0.1.19

package/dist/cli.mjs

@@ -4,7 +4,7 @@ import { createRequire } from "node:module";
 import { spawn } from "node:child_process";
 import { command, flag, option, optional, positional, run, string, subcommands } from "cmd-ts";
 import { existsSync, readFileSync } from "node:fs";
-import { access, copyFile, mkdir, mkdtemp, readFile, readdir, rm, stat, writeFile } from "node:fs/promises";
+import { access, appendFile, copyFile, mkdir, mkdtemp, readFile, readdir, rm, stat, writeFile } from "node:fs/promises";
 import path from "node:path";
 import matter from "gray-matter";
 import { Lexer, Marked, Parser, Renderer, marked } from "marked";
@@ -516,7 +516,10 @@ async function frontendViteConfig(cwd, mode) {
 		clearScreen: false,
 		logLevel: "warn",
 		plugins: [octaneRuntimeCompatibility(), octane()],
-		optimizeDeps: { exclude: ["octane"] },
+		optimizeDeps: {
+			exclude: ["octane"],
+			...mode === "dev" ? { noDiscovery: true } : {}
+		},
 		ssr: { noExternal: [/^octane(?:$|\/)/] }
 	};
 }
@@ -1062,12 +1065,14 @@ async function buildReferencePages(options) {
 			outDir: tempDir
 		});
 		const markdownPaths = await collectMarkdownPaths(tempDir);
+		const packageName = packageJsonData.name;
+		if (typeof packageName !== "string" || !packageName) throw new Error(`Package name not found: ${packageJson.packagePath}`);
 		return Promise.all(markdownPaths.map(async (sourcePath) => {
-			const generatedPath = toPosixPath(path.relative(tempDir, sourcePath));
+			const rawMarkdown = await readFile(sourcePath, "utf8");
 			return {
 				sourcePath,
-				relativePath: toPosixPath(path.posix.join("reference", generatedPath)),
-				rawMarkdown: await readFile(sourcePath, "utf8")
+				relativePath: referenceMarkdownPath(rawMarkdown, packageName),
+				rawMarkdown
 			};
 		}));
 	} catch (error) {
@@ -1103,6 +1108,11 @@ async function readPackageJson(packagePath) {
 		throw error;
 	}
 }
+function referenceMarkdownPath(rawMarkdown, packageName) {
+	const packageSpecifier = rawMarkdown.match(/^#\s+(.+)$/m)?.[1]?.trim();
+	if (!packageSpecifier || packageSpecifier !== packageName && !packageSpecifier.startsWith(`${packageName}/`) || packageSpecifier.split("/").some((part) => !part || part === "." || part === "..")) throw new Error(`Invalid package entry heading: ${packageSpecifier ?? "missing"}`);
+	return toPosixPath(path.posix.join("reference", `${packageSpecifier}.md`));
+}
 function errorMessage(error) {
 	if (error instanceof Error) return error.message;
 	return String(error);
@@ -1847,6 +1857,7 @@ async function startDevServer(options) {
 	const input = await resolveInput(options.input, options.cwd, { homePagePreference: "readme-first" });
 	const outDir = path.resolve(options.cwd, options.outDir);
 	validateDevOutDir(options.cwd, input.docsRoot, outDir, options.outDir);
+	await addGitExclude(options.cwd, outDir);
 	await mkdir(outDir, { recursive: true });
 	const vite = await createFrontendDevServer({
 		cwd: options.cwd,
@@ -1941,6 +1952,56 @@ function isInside(parent, child) {
 	const relative = path.relative(parent, child);
 	return relative === "" || !relative.startsWith("..") && !path.isAbsolute(relative);
 }
+async function addGitExclude(cwd, outDir) {
+	try {
+		const repository = await findGitRepository(cwd);
+		if (!repository || !isInside(repository.root, outDir)) return;
+		const relativeOutDir = path.relative(repository.root, outDir);
+		if (!relativeOutDir) return;
+		const pattern = `${relativeOutDir.split(path.sep).join("/")}/`;
+		let contents = "";
+		try {
+			contents = await readFile(repository.excludePath, "utf8");
+		} catch (error) {
+			if (error.code !== "ENOENT") throw error;
+			await mkdir(path.dirname(repository.excludePath), { recursive: true });
+		}
+		const entries = contents.split(/\r?\n/).map((entry) => entry.trim());
+		const normalizedPattern = pattern.replace(/^\/|\/$/g, "");
+		if (entries.some((entry) => entry.replace(/^\/|\/$/g, "") === normalizedPattern)) return;
+		const separator = contents.length > 0 && !contents.endsWith("\n") ? "\n" : "";
+		await appendFile(repository.excludePath, `${separator}${pattern}\n`);
+	} catch {}
+}
+async function findGitRepository(start) {
+	let current = path.resolve(start);
+	while (true) {
+		const dotGit = path.join(current, ".git");
+		try {
+			const metadata = await stat(dotGit);
+			let gitDir = dotGit;
+			if (!metadata.isDirectory()) {
+				const pointer = await readFile(dotGit, "utf8");
+				const match = /^gitdir:\s*(.+)\s*$/im.exec(pointer);
+				if (!match?.[1]) return;
+				gitDir = path.resolve(current, match[1]);
+			}
+			let commonDir = gitDir;
+			try {
+				const pointer = (await readFile(path.join(gitDir, "commondir"), "utf8")).trim();
+				commonDir = path.resolve(gitDir, pointer);
+			} catch {}
+			return {
+				root: current,
+				excludePath: path.join(commonDir, "info", "exclude")
+			};
+		} catch {
+			const parent = path.dirname(current);
+			if (parent === current) return;
+			current = parent;
+		}
+	}
+}
 //#endregion
 //#region src/core/deploy.ts
 async function deployGitHubPages(options) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lildocs",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "A lightweight CLI that turns Markdown docs into a static searchable documentation site.",
   "homepage": "https://aleclarson.github.io/lildocs/",
   "repository": {