mdzilla 0.0.3 → 0.0.5

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 { execSync } from "node:child_process";
+import { exec, execSync } 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[";
@@ -730,6 +730,14 @@ 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) => {
@@ -752,7 +760,8 @@ async function main() {
 				type: "boolean",
 				default: isAgent || !process.stdout.isTTY
 			},
-			headless: { type: "boolean" }
+			headless: { type: "boolean" },
+			tui: { type: "boolean" }
 		},
 		allowPositionals: true
 	});
@@ -762,7 +771,8 @@ async function main() {
 	if (values.help || !docsDir) return printUsage(!!docsDir);
 	const isURL = docsDir.startsWith("http://") || docsDir.startsWith("https://");
 	if (docsDir.endsWith(".md")) return singleFileMode(docsDir, plain, isURL);
-	const docs = new DocsManager(isURL ? new DocsSourceHTTP(docsDir) : docsDir.startsWith("gh:") ? new DocsSourceGit(docsDir) : docsDir.startsWith("npm:") ? new DocsSourceNpm(docsDir) : new DocsSourceFS(docsDir));
+	const source = isURL ? new DocsSourceHTTP(docsDir) : docsDir.startsWith("gh:") ? new DocsSourceGit(docsDir) : docsDir.startsWith("npm:") ? new DocsSourceNpm(docsDir) : new DocsSourceFS(docsDir);
+	const docs = new DocsManager(source);
 	await docs.load();
 	if (exportDir) {
 		await exportDocsToFS(docs, exportDir, { plainText: plain });
@@ -776,7 +786,18 @@ async function main() {
 	}
 	if (pagePath && !plain) return pageMode(docs, pagePath, plain);
 	if (plain) return plainMode(docs, pagePath);
-	return interactiveMode(docs);
+	if (values.tui) interactiveMode(docs);
+	else {
+		const { serve } = await import("srvx");
+		const { createDocsServer } = await import("../_chunks/server.mjs");
+		const server = serve({
+			fetch: (await createDocsServer({ source })).fetch,
+			gracefulShutdown: false
+		});
+		await server.ready();
+		await server.fetch(new Request(new URL("/api/meta", server.url)));
+		openInBrowser(server.url);
+	}
 }
 main().catch((err) => {
 	showCursor();

package/dist/index.d.mts

@@ -156,8 +156,9 @@ interface ExportOptions {
 /**
  * Export documentation entries to a local filesystem directory as flat `.md` files.
  *
- * Each entry is written to `<dir>/<path>.md`. Directory stubs (`page === false`)
- * are skipped by default unless a custom `filter` is provided.
+ * Each entry is written to `<dir>/<path>.md` (or `<dir>/<path>/index.md` for directory
+ * index pages). Navigation order is preserved via `order` frontmatter in pages and
+ * `.navigation.yml` files in directories.
  *
  * A `README.md` table of contents is generated at the root of the output directory.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mdzilla",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "",
   "license": "MIT",
   "repository": "pi0/mdzilla",
@@ -34,6 +34,7 @@
     "giget": "^3.1.2",
     "md4x": ">=0.0.22",
     "mdream": "^0.16.0",
+    "srvx": "^0.11.9",
     "std-env": "4.0.0-rc.1"
   },
   "devDependencies": {