@openpkg-ts/doc-generator 0.6.2 → 0.6.4

package/dist/cli.js

@@ -1,387 +0,0 @@
-#!/usr/bin/env node
-import {
-  __require,
-  __toESM,
-  createDocs,
-  exportToMarkdown,
-  toDocusaurusSidebarJS,
-  toFumadocsMetaJSON,
-  toHTML,
-  toJSONString,
-  toNavigation,
-  toPagefindRecords
-} from "./shared/server-4yabn81t.js";
-
-// src/cli.ts
-import { readFileSync } from "node:fs";
-import * as path4 from "node:path";
-import { fileURLToPath } from "node:url";
-import { Command } from "commander";
-
-// src/cli/build.ts
-import { exec } from "node:child_process";
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { promisify } from "node:util";
-var execAsync = promisify(exec);
-function registerBuildCommand(program) {
-  program.command("build <spec>").description("Build static HTML documentation site").option("-o, --out <dir>", "Output directory", "./api-docs").option("-t, --title <title>", "Site title override").option("--no-search", "Disable Pagefind search indexing").option("--verbose", "Verbose output").action(async (specPath, options) => {
-    try {
-      const resolvedSpec = path.resolve(specPath);
-      if (!fs.existsSync(resolvedSpec)) {
-        console.error(`Error: Spec file not found: ${resolvedSpec}`);
-        process.exit(1);
-      }
-      const docs = createDocs(resolvedSpec);
-      const outDir = path.resolve(options.out);
-      const exports = docs.getAllExports();
-      if (options.verbose) {
-        console.log(`Spec: ${resolvedSpec}`);
-        console.log(`Output: ${outDir}`);
-        console.log(`Exports: ${exports.length}`);
-      }
-      fs.mkdirSync(outDir, { recursive: true });
-      console.log("Generating HTML...");
-      const indexHtml = toHTML(docs.spec, {
-        title: options.title,
-        includeStyles: true,
-        fullDocument: true
-      });
-      fs.writeFileSync(path.join(outDir, "index.html"), indexHtml);
-      const pagesDir = path.join(outDir, "api");
-      fs.mkdirSync(pagesDir, { recursive: true });
-      for (const exp of exports) {
-        const exportHtml = toHTML(docs.spec, {
-          export: exp.name,
-          title: options.title ? `${exp.name} | ${options.title}` : undefined,
-          includeStyles: true,
-          fullDocument: true,
-          headContent: `<link rel="canonical" href="./api/${slugify(exp.name)}.html">`
-        });
-        const filename = `${slugify(exp.name)}.html`;
-        fs.writeFileSync(path.join(pagesDir, filename), exportHtml);
-        if (options.verbose) {
-          console.log(`  api/${filename}`);
-        }
-      }
-      console.log(`Generated ${exports.length + 1} HTML files`);
-      if (options.search !== false) {
-        console.log("Building search index...");
-        try {
-          await execAsync(`npx pagefind --site ${outDir} --output-subdir _pagefind`, {
-            cwd: process.cwd()
-          });
-          console.log("Search index created");
-        } catch (err) {
-          if (options.verbose) {
-            console.log("Pagefind not available, generating search.json fallback");
-          }
-          const records = toPagefindRecords(docs.spec, {
-            baseUrl: "/api"
-          });
-          fs.writeFileSync(path.join(outDir, "search.json"), JSON.stringify(records, null, 2));
-          console.log("Generated search.json fallback");
-        }
-      }
-      console.log(`
-Build complete: ${outDir}`);
-      console.log(`
-To serve locally:`);
-      console.log(`  npx serve ${outDir}`);
-    } catch (err) {
-      console.error("Error:", err instanceof Error ? err.message : err);
-      process.exit(1);
-    }
-  });
-}
-function slugify(name) {
-  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-");
-}
-
-// src/cli/dev.ts
-import * as fs2 from "node:fs";
-import * as http from "node:http";
-import * as path2 from "node:path";
-function registerDevCommand(program) {
-  program.command("dev <spec>").description("Start dev server with hot reload").option("-p, --port <port>", "Port to serve on", "3001").option("-h, --host <host>", "Host to bind to", "localhost").option("--open", "Open browser on start").option("--verbose", "Verbose output").action(async (specPath, options) => {
-    try {
-      const resolvedSpec = path2.resolve(specPath);
-      if (!fs2.existsSync(resolvedSpec)) {
-        console.error(`Error: Spec file not found: ${resolvedSpec}`);
-        process.exit(1);
-      }
-      const port = Number.parseInt(options.port, 10);
-      const host = options.host ?? "localhost";
-      let docs = createDocs(resolvedSpec);
-      let lastMtime = fs2.statSync(resolvedSpec).mtimeMs;
-      console.log(`
-Starting dev server...`);
-      console.log(`  Spec: ${resolvedSpec}`);
-      console.log(`  Exports: ${docs.getAllExports().length}`);
-      const watcher = fs2.watch(resolvedSpec, (eventType) => {
-        if (eventType === "change") {
-          const currentMtime = fs2.statSync(resolvedSpec).mtimeMs;
-          if (currentMtime !== lastMtime) {
-            lastMtime = currentMtime;
-            try {
-              docs = createDocs(resolvedSpec);
-              console.log(`
-[${new Date().toLocaleTimeString()}] Spec reloaded (${docs.getAllExports().length} exports)`);
-            } catch (err) {
-              console.error(`
-[${new Date().toLocaleTimeString()}] Error reloading spec:`, err instanceof Error ? err.message : err);
-            }
-          }
-        }
-      });
-      const server = http.createServer((req, res) => {
-        const url = new URL(req.url || "/", `http://${host}:${port}`);
-        const pathname = url.pathname;
-        if (options.verbose) {
-          console.log(`${req.method} ${pathname}`);
-        }
-        try {
-          if (pathname.startsWith("/api/")) {
-            const exportName = pathname.replace("/api/", "").replace(".html", "").replace(/-/g, "");
-            const exp = findExport(docs, exportName);
-            if (exp) {
-              const html = toHTML(docs.spec, {
-                export: exp.name,
-                includeStyles: true,
-                fullDocument: true,
-                headContent: hotReloadScript(port)
-              });
-              res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
-              res.end(html);
-              return;
-            }
-          }
-          if (pathname === "/" || pathname === "/index.html") {
-            const html = toHTML(docs.spec, {
-              includeStyles: true,
-              fullDocument: true,
-              headContent: hotReloadScript(port)
-            });
-            res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
-            res.end(html);
-            return;
-          }
-          if (pathname === "/__reload") {
-            res.writeHead(200, {
-              "Content-Type": "text/event-stream",
-              "Cache-Control": "no-cache",
-              Connection: "keep-alive"
-            });
-            const interval = setInterval(() => {
-              res.write(`data: ping
-
-`);
-            }, 2000);
-            const reloadWatcher = fs2.watch(resolvedSpec, () => {
-              res.write(`data: reload
-
-`);
-            });
-            req.on("close", () => {
-              clearInterval(interval);
-              reloadWatcher.close();
-            });
-            return;
-          }
-          res.writeHead(404, { "Content-Type": "text/html" });
-          res.end("<h1>404 Not Found</h1>");
-        } catch (err) {
-          console.error("Server error:", err);
-          res.writeHead(500, { "Content-Type": "text/html" });
-          res.end(`<h1>500 Server Error</h1><pre>${err instanceof Error ? err.message : err}</pre>`);
-        }
-      });
-      server.listen(port, host, () => {
-        console.log(`
-  Local:   http://${host}:${port}/`);
-        console.log(`
-  Watching for spec changes...`);
-        console.log(`  Press Ctrl+C to stop
-`);
-        if (options.open) {
-          const openCmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
-          import("node:child_process").then(({ exec: exec2 }) => {
-            exec2(`${openCmd} http://${host}:${port}/`);
-          });
-        }
-      });
-      process.on("SIGINT", () => {
-        console.log(`
-
-Shutting down...`);
-        watcher.close();
-        server.close();
-        process.exit(0);
-      });
-    } catch (err) {
-      console.error("Error:", err instanceof Error ? err.message : err);
-      process.exit(1);
-    }
-  });
-}
-function findExport(docs, searchName) {
-  const lowerSearch = searchName.toLowerCase();
-  return docs.getAllExports().find((exp) => {
-    const lowerName = exp.name.toLowerCase().replace(/[^a-z0-9]/g, "");
-    return lowerName === lowerSearch || exp.id === searchName;
-  });
-}
-function hotReloadScript(port) {
-  return `
-<script>
-(function() {
-  const source = new EventSource('http://localhost:${port}/__reload');
-  source.onmessage = function(e) {
-    if (e.data === 'reload') {
-      window.location.reload();
-    }
-  };
-  source.onerror = function() {
-    source.close();
-    setTimeout(() => window.location.reload(), 1000);
-  };
-})();
-</script>`;
-}
-
-// src/cli/generate.ts
-import * as fs3 from "node:fs";
-import * as path3 from "node:path";
-function slugify2(name) {
-  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-");
-}
-function registerGenerateCommand(program) {
-  program.command("generate <spec>").description("Generate MDX or JSON files from OpenPkg spec").option("-o, --out <dir>", "Output directory", "./api-docs").option("-f, --format <format>", "Output format: mdx or json", "mdx").option("--nav <format>", "Navigation format: fumadocs, docusaurus, generic").option("--flat", "Flat file structure (no grouping folders)").option("--group-by <groupBy>", "Group by: kind, module, tag, none", "kind").option("--base-path <path>", "Base path for navigation links", "/api").option("--verbose", "Verbose output").action(async (specPath, options) => {
-    try {
-      const resolvedSpec = path3.resolve(specPath);
-      if (!fs3.existsSync(resolvedSpec)) {
-        console.error(`Error: Spec file not found: ${resolvedSpec}`);
-        process.exit(1);
-      }
-      const docs = createDocs(resolvedSpec);
-      const exports = docs.getAllExports();
-      const outDir = path3.resolve(options.out);
-      if (options.verbose) {
-        console.log(`Spec: ${resolvedSpec}`);
-        console.log(`Output: ${outDir}`);
-        console.log(`Format: ${options.format}`);
-        console.log(`Exports: ${exports.length}`);
-      }
-      fs3.mkdirSync(outDir, { recursive: true });
-      if (options.format === "json") {
-        const jsonContent = toJSONString(docs.spec, { pretty: true });
-        const jsonPath = path3.join(outDir, "api.json");
-        fs3.writeFileSync(jsonPath, jsonContent);
-        console.log(`Generated ${jsonPath}`);
-      } else {
-        const groupBy = options.groupBy ?? "kind";
-        const isFlat = options.flat ?? false;
-        const groups = new Map;
-        for (const exp of exports) {
-          let groupKey;
-          if (isFlat || groupBy === "none") {
-            groupKey = "";
-          } else if (groupBy === "kind") {
-            groupKey = `${exp.kind}s`;
-          } else if (groupBy === "module") {
-            groupKey = extractModule(exp.source?.file) || "core";
-          } else if (groupBy === "tag") {
-            const categoryTag = exp.tags?.find((t) => t.name === "category" || t.name === "@category");
-            groupKey = categoryTag?.text || "other";
-          } else {
-            groupKey = "";
-          }
-          const existing = groups.get(groupKey) ?? [];
-          existing.push(exp);
-          groups.set(groupKey, existing);
-        }
-        let fileCount = 0;
-        for (const [group, groupExports] of groups) {
-          const groupDir = group ? path3.join(outDir, slugify2(group)) : outDir;
-          if (group) {
-            fs3.mkdirSync(groupDir, { recursive: true });
-          }
-          for (const exp of groupExports) {
-            const mdx = exportToMarkdown(exp, {
-              frontmatter: true,
-              codeSignatures: true
-            });
-            const filename = `${slugify2(exp.name)}.mdx`;
-            const filePath = path3.join(groupDir, filename);
-            fs3.writeFileSync(filePath, mdx);
-            fileCount++;
-            if (options.verbose) {
-              console.log(`  ${group ? `${group}/` : ""}${filename}`);
-            }
-          }
-        }
-        console.log(`Generated ${fileCount} MDX files in ${outDir}`);
-      }
-      if (options.nav) {
-        const basePath = options.basePath ?? "/api";
-        const navOptions = {
-          format: options.nav,
-          groupBy: options.groupBy ?? "kind",
-          basePath
-        };
-        let navContent;
-        let navFilename;
-        switch (options.nav) {
-          case "fumadocs":
-            navContent = toFumadocsMetaJSON(docs.spec, navOptions);
-            navFilename = "meta.json";
-            break;
-          case "docusaurus":
-            navContent = toDocusaurusSidebarJS(docs.spec, navOptions);
-            navFilename = "sidebars.js";
-            break;
-          default:
-            navContent = JSON.stringify(toNavigation(docs.spec, navOptions), null, 2);
-            navFilename = "nav.json";
-            break;
-        }
-        const navPath = path3.join(outDir, navFilename);
-        fs3.writeFileSync(navPath, navContent);
-        console.log(`Generated ${navPath}`);
-      }
-    } catch (err) {
-      console.error("Error:", err instanceof Error ? err.message : err);
-      process.exit(1);
-    }
-  });
-}
-function extractModule(filePath) {
-  if (!filePath)
-    return;
-  const parts = filePath.split("/");
-  const lastPart = parts[parts.length - 1];
-  if (lastPart === "index.ts" || lastPart === "index.tsx") {
-    return parts[parts.length - 2];
-  }
-  return lastPart.replace(/\.[jt]sx?$/, "");
-}
-
-// src/cli.ts
-var __filename2 = fileURLToPath(import.meta.url);
-var __dirname2 = path4.dirname(__filename2);
-var version = "0.0.1";
-try {
-  const packageJson = JSON.parse(readFileSync(path4.join(__dirname2, "../package.json"), "utf-8"));
-  version = packageJson.version;
-} catch {}
-var program = new Command;
-program.name("openpkg-docs").description("Generate API documentation from OpenPkg specs").version(version).option("-c, --config <path>", "Config file path").option("-v, --verbose", "Verbose output");
-registerBuildCommand(program);
-registerGenerateCommand(program);
-registerDevCommand(program);
-program.command("*", { hidden: true }).action(() => {
-  program.outputHelp();
-});
-program.parseAsync().catch(() => {
-  process.exit(1);
-});