docsui-cli 0.0.59

package/dist/commands/doctor.js

@@ -0,0 +1,250 @@
+import { Command } from "commander";
+import chalk from "chalk";
+import fs from "fs-extra";
+import path from "path";
+import { getConfig } from "../utils/get-config.js";
+import { COMPONENT_FILES, COMPONENT_DEPS } from "../lib/component-registry.js";
+async function getInstalledDeps(cwd) {
+  const installed = /* @__PURE__ */ new Set();
+  const p = path.join(cwd, "package.json");
+  if (!await fs.pathExists(p)) return installed;
+  try {
+    const pkg = await fs.readJSON(p);
+    const allDeps = {
+      ...pkg.dependencies,
+      ...pkg.devDependencies,
+      ...pkg.peerDependencies
+    };
+    Object.keys(allDeps).forEach((d) => installed.add(d));
+  } catch {
+  }
+  return installed;
+}
+const doctor = new Command().name("doctor").description(
+  "Check your project for missing dependencies or broken component setup"
+).action(async () => {
+  console.log();
+  console.log(chalk.bold("Running docsui doctor...\n"));
+  const issues = [];
+  const cwd = process.cwd();
+  const config = await getConfig();
+  if (!config) {
+    issues.push({
+      level: "error",
+      message: "No docsui.json found \u2014 run: npx docsui-cli@latest init"
+    });
+    printReport(issues);
+    return;
+  }
+  console.log(
+    `  ${chalk.green("\u2713")}  docsui.json found  ${chalk.dim(`(componentsDir: ${config.componentsDir})`)}`
+  );
+  const compDir = path.join(cwd, config.componentsDir);
+  if (!await fs.pathExists(compDir)) {
+    issues.push({
+      level: "error",
+      message: `Components directory not found: ${config.componentsDir}`
+    });
+    printReport(issues);
+    return;
+  }
+  const files = await fs.readdir(compDir);
+  const installed = [];
+  for (const [name, compFiles] of Object.entries(COMPONENT_FILES)) {
+    const ownFiles = compFiles.filter((f) => !f.startsWith("lib/"));
+    if (ownFiles.length > 0 && ownFiles.every((f) => files.includes(f)))
+      installed.push(name);
+  }
+  if (installed.length === 0) {
+    console.log(
+      chalk.yellow("  No docsui components found in components directory.")
+    );
+    printReport(issues);
+    return;
+  }
+  console.log(
+    `  ${chalk.green("\u2713")}  ${installed.length} component${installed.length !== 1 ? "s" : ""} installed  ${chalk.dim(`(${installed.join(", ")})`)}
+`
+  );
+  const libDir = config.componentsDir.startsWith("src/") ? "src/lib" : "lib";
+  const utilsPath = path.join(cwd, libDir, "utils.ts");
+  if (!await fs.pathExists(utilsPath)) {
+    issues.push({
+      level: "error",
+      message: `lib/utils.ts not found \u2014 run: npx docsui-cli@latest add utils`
+    });
+  } else {
+    console.log(`  ${chalk.green("\u2713")}  ${libDir}/utils.ts`);
+  }
+  const installedDeps = await getInstalledDeps(cwd);
+  const missingDeps = /* @__PURE__ */ new Set();
+  for (const name of installed) {
+    for (const dep of COMPONENT_DEPS[name] ?? []) {
+      if (!installedDeps.has(dep)) missingDeps.add(dep);
+    }
+  }
+  if (missingDeps.size > 0) {
+    for (const dep of missingDeps) {
+      issues.push({
+        level: "error",
+        message: `Missing npm dependency: ${dep}`
+      });
+    }
+    console.log();
+    console.log(
+      `  ${chalk.red("\u2717")}  Missing deps: ${chalk.bold([...missingDeps].join(", "))}`
+    );
+    console.log(`     Fix: npm install ${[...missingDeps].join(" ")}`);
+  } else {
+    console.log(`  ${chalk.green("\u2713")}  All npm dependencies present`);
+  }
+  if (config.cssFile) {
+    const cssPath = path.join(cwd, config.cssFile);
+    if (!await fs.pathExists(cssPath)) {
+      issues.push({
+        level: "warn",
+        message: `CSS file not found: ${config.cssFile}`
+      });
+    } else {
+      const cssContent = await fs.readFile(cssPath, "utf-8");
+      if (!cssContent.includes("--mdxui-info-bg")) {
+        issues.push({
+          level: "warn",
+          message: `Missing docsui semantic tokens in ${config.cssFile} \u2014 re-run: npx docsui-cli@latest init`
+        });
+        console.log(
+          `  ${chalk.yellow("~")}  --mdxui-* tokens missing from ${config.cssFile}`
+        );
+      } else {
+        console.log(
+          `  ${chalk.green("\u2713")}  docsui CSS tokens in ${config.cssFile}`
+        );
+      }
+    }
+  }
+  if (config.tailwindConfig) {
+    const twPath = path.join(cwd, config.tailwindConfig);
+    if (await fs.pathExists(twPath)) {
+      const twContent = await fs.readFile(twPath, "utf-8");
+      if (!twContent.includes("--mdxui-info-border")) {
+        issues.push({
+          level: "warn",
+          message: `docsui semantic colors missing from ${config.tailwindConfig} \u2014 re-run: npx docsui-cli@latest init`
+        });
+        console.log(
+          `  ${chalk.yellow("~")}  docsui colors missing from ${config.tailwindConfig}`
+        );
+      } else {
+        console.log(
+          `  ${chalk.green("\u2713")}  docsui colors in ${config.tailwindConfig}`
+        );
+      }
+    }
+  }
+  const mdxPath = path.join(cwd, config.componentsDir, "mdx-components.tsx");
+  if (!await fs.pathExists(mdxPath)) {
+    issues.push({
+      level: "warn",
+      message: "mdx-components.tsx not found \u2014 component auto-mapping unavailable"
+    });
+  } else {
+    const mdxContent = await fs.readFile(mdxPath, "utf-8");
+    const notMapped = [];
+    for (const name of installed) {
+      if (!mdxContent.includes(`from "./${name}"`)) notMapped.push(name);
+    }
+    if (notMapped.length > 0) {
+      issues.push({
+        level: "warn",
+        message: `Not imported in mdx-components.tsx: ${notMapped.join(", ")} \u2014 re-run add for these components`
+      });
+      console.log();
+      console.log(
+        `  ${chalk.yellow("~")}  Not mapped in mdx-components.tsx: ${notMapped.join(", ")}`
+      );
+    } else {
+      console.log(`  ${chalk.green("\u2713")}  mdx-components.tsx looks good`);
+    }
+  }
+  const remarkPkg = "@docsui-io/remark-plugin";
+  if (!installedDeps.has(remarkPkg)) {
+    issues.push({
+      level: "warn",
+      message: `${remarkPkg} not installed \u2014 markdown won't auto-upgrade to components. Run: npm install ${remarkPkg}`
+    });
+    console.log(`  ${chalk.yellow("~")}  ${remarkPkg} not installed`);
+  } else {
+    const pipeline = config.mdxPipeline ?? "unknown";
+    const wired = await checkRemarkPluginWired(pipeline, cwd);
+    if (wired === null) {
+      console.log(`  ${chalk.green("\u2713")}  ${remarkPkg} installed`);
+    } else if (!wired) {
+      issues.push({
+        level: "warn",
+        message: `remarkMdxUi not found in ${pipeline} config \u2014 add it to remarkPlugins`
+      });
+      console.log(
+        `  ${chalk.yellow("~")}  remarkMdxUi not wired in ${pipeline} config`
+      );
+    } else {
+      console.log(
+        `  ${chalk.green("\u2713")}  remarkMdxUi wired in ${pipeline} config`
+      );
+    }
+  }
+  printReport(issues);
+});
+async function checkRemarkPluginWired(pipeline, cwd) {
+  const CONFIG_CANDIDATES = {
+    contentlayer: ["contentlayer.config.ts", "contentlayer.config.js"],
+    "next-mdx": [
+      "next.config.ts",
+      "next.config.mjs",
+      "next.config.js",
+      "next.config.cjs"
+    ],
+    "astro-mdx": ["astro.config.ts", "astro.config.mjs"],
+    "mdx-rollup": ["vite.config.ts", "vite.config.js", "vite.config.mts"]
+  };
+  const candidates = CONFIG_CANDIDATES[pipeline];
+  if (!candidates) return null;
+  for (const candidate of candidates) {
+    const p = path.join(cwd, candidate);
+    if (!await fs.pathExists(p)) continue;
+    const content = await fs.readFile(p, "utf-8");
+    const uncommented = content.split("\n").filter((line) => !/^\s*(\/\/|\/\*|\*)/.test(line)).join("\n");
+    return uncommented.includes("remarkMdxUi") || uncommented.includes("@docsui-io/remark-plugin");
+  }
+  return false;
+}
+function printReport(issues) {
+  console.log();
+  if (issues.length === 0) {
+    console.log(chalk.green(chalk.bold("All checks passed.")));
+    console.log();
+    return;
+  }
+  const errors = issues.filter((i) => i.level === "error");
+  const warns = issues.filter((i) => i.level === "warn");
+  if (errors.length > 0) {
+    console.log(
+      chalk.red(
+        chalk.bold(`${errors.length} error${errors.length !== 1 ? "s" : ""}:`)
+      )
+    );
+    for (const e of errors) console.log(`  ${chalk.red("\u2717")}  ${e.message}`);
+    console.log();
+  }
+  if (warns.length > 0) {
+    console.log(
+      chalk.yellow(
+        chalk.bold(`${warns.length} warning${warns.length !== 1 ? "s" : ""}:`)
+      )
+    );
+    for (const w of warns) console.log(`  ${chalk.yellow("~")}  ${w.message}`);
+    console.log();
+  }
+}
+export {
+  doctor
+};

package/dist/commands/init.d.ts

@@ -0,0 +1,5 @@
+import { Command } from 'commander';
+
+declare const init: Command;
+
+export { init };