mdzilla 0.0.5 → 0.1.0

package/dist/cli/main.mjs

@@ -6,7 +6,7 @@ import { parseMeta, renderToAnsi, renderToText } from "md4x";
 import { parseArgs } from "node:util";
 import { isAgent } from "std-env";
 import { highlightText } from "@speed-highlight/core/terminal";
-import { exec, execSync } from "node:child_process";
+import { exec, execFile } from "node:child_process";
 //#region src/cli/_ansi.ts
 const noColor = !!(process.env.NO_COLOR || process.env.TERM === "dumb" || !process.stdout.isTTY || isAgent);
 const ESC = "\x1B[";
@@ -273,8 +273,10 @@ async function pageMode(docs, pagePath, plain) {
 		title: parseMeta(raw).title || slug,
 		order: 0
 	};
-	if (plain) process.stdout.write(renderToText(raw) + "\n");
-	else {
+	if (plain) {
+		process.stdout.write(renderToText(raw) + "\n");
+		if (isAgent) process.stdout.write(agentTrailer(docs, normalized));
+	} else {
 		const lines = await renderContent(raw, navEntry, 0);
 		process.stdout.write(lines.join("\n") + "\n");
 	}
@@ -285,20 +287,54 @@ async function plainMode(docs, pagePath) {
 		console.log("No pages found.");
 		return;
 	}
+	if (isAgent && pagePath) {
+		const normalized = pagePath.startsWith("/") ? pagePath : "/" + pagePath;
+		const resolved = await docs.resolvePage(normalized);
+		if (resolved.raw) process.stdout.write(renderToText(resolved.raw) + "\n");
+		else process.stdout.write(`Page not found: ${pagePath}\n`);
+		process.stdout.write(agentTrailer(docs, normalized));
+		return;
+	}
 	const tocLines = ["Table of Contents", ""];
 	for (const f of navigable) {
 		const indent = "  ".repeat(f.depth);
 		tocLines.push(`${indent}- [${f.entry.title}](${f.entry.path})`);
 	}
 	process.stdout.write(tocLines.join("\n") + "\n");
-	let targetEntry = navigable[0];
 	if (pagePath) {
 		const resolved = await docs.resolvePage(pagePath);
 		if (resolved.raw) process.stdout.write(renderToText(resolved.raw) + "\n\n");
 	} else {
-		const raw = await docs.getContent(targetEntry);
+		const raw = await docs.getContent(navigable[0]);
 		if (raw) process.stdout.write(renderToText(raw) + "\n\n");
 	}
+	if (isAgent && navigable.length > 1) process.stdout.write("\n---\n\nTo read a specific page from the table of contents above, run this command again with `--page <path>`.\n");
+}
+function agentTrailer(docs, currentPath) {
+	const pages = docs.pages;
+	if (pages.length <= 1) return "";
+	const normalized = currentPath?.startsWith("/") ? currentPath : currentPath ? "/" + currentPath : void 0;
+	const otherPages = pages.filter((p) => p.entry.path !== normalized);
+	if (otherPages.length === 0) return "";
+	return "\n" + [
+		"---",
+		"",
+		"Other available pages:",
+		...otherPages.map((p) => `  - [${p.entry.title}](${p.entry.path})`),
+		"",
+		"To read a specific page, run this command again with `--page <path>`.",
+		"To view the full table of contents, run this command without `--page`.",
+		""
+	].join("\n");
+}
+//#endregion
+//#region src/cli/_utils.ts
+function openInBrowser(url) {
+	const parsed = new URL(url);
+	if (parsed.hostname === "[::]" || parsed.hostname === "[::1]" || parsed.hostname === "127.0.0.1") parsed.hostname = "localhost";
+	url = parsed.href;
+	if (process.platform === "win32") exec(`start "" ${JSON.stringify(url)}`, () => {});
+	else execFile(process.platform === "darwin" ? "open" : "xdg-open", [url], () => {});
 }
 //#endregion
 //#region src/cli/interactive/nav.ts
@@ -603,9 +639,7 @@ async function interactiveMode(docs) {
 		if (line < contentScroll || line >= contentScroll + rows - 2) contentScroll = Math.max(0, Math.min(line - Math.floor(rows / 3), contentLines.length - rows + 2));
 	};
 	const activateLink = (url) => {
-		if (url.startsWith("http://") || url.startsWith("https://")) try {
-			execSync(`open ${JSON.stringify(url)}`, { stdio: "ignore" });
-		} catch {}
+		if (url.startsWith("http://") || url.startsWith("https://")) openInBrowser(url);
 		else {
 			const target = url.replace(/^\.\//, "/").replace(/\/$/, "");
 			const idx = flat.indexOf(docs.findByPath(target));
@@ -730,14 +764,6 @@ async function interactiveMode(docs) {
 	}
 }
 //#endregion
-//#region src/cli/_utils.ts
-function openInBrowser(url) {
-	const parsed = new URL(url);
-	if (parsed.hostname === "[::]" || parsed.hostname === "[::1]" || parsed.hostname === "127.0.0.1") parsed.hostname = "localhost";
-	url = parsed.href;
-	exec(process.platform === "win32" ? `start ${url}` : process.platform === "darwin" ? `open ${url}` : `xdg-open ${url}`, () => {});
-}
-//#endregion
 //#region src/cli/main.ts
 async function main() {
 	process.stdout.on("error", (err) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mdzilla",
-  "version": "0.0.5",
+  "version": "0.1.0",
   "description": "",
   "license": "MIT",
   "repository": "pi0/mdzilla",
@@ -30,24 +30,23 @@
     "typecheck": "tsgo --noEmit --skipLibCheck"
   },
   "dependencies": {
-    "@speed-highlight/core": "^1.2.14",
+    "@speed-highlight/core": "^1.2.15",
     "giget": "^3.1.2",
-    "md4x": ">=0.0.22",
-    "mdream": "^0.16.0",
-    "srvx": "^0.11.9",
-    "std-env": "4.0.0-rc.1"
+    "md4x": "^0.0.25",
+    "srvx": "^0.11.13",
+    "std-env": "^4.0.0"
   },
   "devDependencies": {
-    "@types/node": "latest",
-    "@typescript/native-preview": "latest",
-    "@vitest/coverage-v8": "latest",
-    "automd": "latest",
-    "changelogen": "latest",
-    "obuild": "latest",
-    "oxfmt": "latest",
-    "oxlint": "latest",
-    "typescript": "latest",
-    "vitest": "latest"
+    "@types/node": "^25.5.0",
+    "@typescript/native-preview": "^7.0.0-dev.20260324.1",
+    "@vitest/coverage-v8": "^4.1.1",
+    "automd": "^0.4.3",
+    "changelogen": "^0.6.2",
+    "obuild": "^0.4.32",
+    "oxfmt": "^0.41.0",
+    "oxlint": "^1.56.0",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.1"
   },
-  "packageManager": "pnpm@10.29.3"
+  "packageManager": "pnpm@10.32.1"
 }