barodoc 7.2.0 → 8.0.0

package/dist/chunk-EFTFHBH3.js

@@ -0,0 +1,183 @@
+// src/runtime/project.ts
+import fs from "fs-extra";
+import path from "path";
+import { fileURLToPath } from "url";
+import pc from "picocolors";
+var BARODOC_DIR = ".barodoc";
+var __dirname = path.dirname(fileURLToPath(import.meta.url));
+function findCliNodeModules() {
+  let best = null;
+  let dir = __dirname;
+  while (dir !== path.parse(dir).root) {
+    const candidate = path.join(dir, "node_modules");
+    if (fs.existsSync(candidate) && fs.existsSync(path.join(candidate, "@barodoc", "theme-docs"))) {
+      best = candidate;
+    }
+    dir = path.dirname(dir);
+  }
+  if (!best) {
+    throw new Error(
+      "Could not locate node_modules for barodoc runtime dependencies"
+    );
+  }
+  return best;
+}
+function isCustomProject(dir) {
+  return fs.existsSync(path.join(dir, "astro.config.mjs")) || fs.existsSync(path.join(dir, "astro.config.ts")) || fs.existsSync(path.join(dir, "astro.config.js"));
+}
+async function loadProjectConfig(dir, configFile) {
+  const configPath = configFile ? path.resolve(dir, configFile) : path.join(dir, "barodoc.config.json");
+  if (fs.existsSync(configPath)) {
+    const content = await fs.readFile(configPath, "utf-8");
+    return {
+      config: JSON.parse(content),
+      configPath
+    };
+  }
+  return {
+    config: getDefaultConfig(),
+    configPath: null
+  };
+}
+function getDefaultConfig() {
+  return {
+    name: "Documentation",
+    navigation: [],
+    i18n: {
+      defaultLocale: "en",
+      locales: ["en"]
+    },
+    search: {
+      enabled: true
+    }
+  };
+}
+async function createProject(options) {
+  const { root, docsDir, config } = options;
+  const projectDir = path.join(root, BARODOC_DIR);
+  console.log(pc.dim(`Creating temporary project in ${BARODOC_DIR}/`));
+  await fs.remove(projectDir);
+  await fs.ensureDir(projectDir);
+  const cliNodeModules = findCliNodeModules();
+  await fs.symlink(cliNodeModules, path.join(projectDir, "node_modules"), "junction");
+  await fs.writeJSON(
+    path.join(projectDir, "package.json"),
+    { name: "barodoc-temp", private: true },
+    { spaces: 2 }
+  );
+  await fs.writeJSON(path.join(projectDir, "barodoc.config.json"), config, {
+    spaces: 2
+  });
+  await fs.writeJSON(
+    path.join(projectDir, "tsconfig.json"),
+    {
+      extends: "astro/tsconfigs/strict",
+      compilerOptions: {
+        jsx: "react-jsx",
+        jsxImportSource: "react"
+      }
+    },
+    { spaces: 2 }
+  );
+  const contentDir = path.join(projectDir, "src/content");
+  await fs.ensureDir(contentDir);
+  const docsAbsolute = path.resolve(root, docsDir);
+  const docsLink = path.join(contentDir, "docs");
+  if (fs.existsSync(docsAbsolute)) {
+    await fs.copy(docsAbsolute, docsLink);
+  } else {
+    await fs.ensureDir(docsLink);
+  }
+  const blogDir = path.join(root, "blog");
+  const blogLink = path.join(contentDir, "blog");
+  if (fs.existsSync(blogDir)) {
+    await fs.copy(blogDir, blogLink);
+  }
+  const changelogDir = path.join(root, "changelog");
+  const changelogLink = path.join(contentDir, "changelog");
+  if (fs.existsSync(changelogDir)) {
+    await fs.copy(changelogDir, changelogLink);
+  }
+  if (config.sections) {
+    for (const section of config.sections) {
+      const sectionDir = path.join(root, section.slug);
+      const sectionDest = path.join(contentDir, section.slug);
+      if (fs.existsSync(sectionDir)) {
+        await fs.copy(sectionDir, sectionDest);
+        console.log(pc.dim(`  Copied ${section.slug}/ section`));
+      }
+    }
+  }
+  const pagesDir = path.join(root, "pages");
+  const pagesDest = path.join(contentDir, "pages");
+  if (fs.existsSync(pagesDir)) {
+    await fs.copy(pagesDir, pagesDest);
+    console.log(pc.dim("  Copied pages/ directory"));
+  }
+  const publicDir = path.join(root, "public");
+  const publicLink = path.join(projectDir, "public");
+  if (fs.existsSync(publicDir)) {
+    await fs.symlink(publicDir, publicLink, "dir");
+  } else {
+    await fs.ensureDir(publicLink);
+  }
+  const overridesDir = path.join(root, "overrides");
+  const overridesLink = path.join(projectDir, "overrides");
+  if (fs.existsSync(overridesDir)) {
+    await fs.symlink(overridesDir, overridesLink, "dir");
+    console.log(pc.dim("  Linked overrides/ directory"));
+  }
+  return projectDir;
+}
+async function cleanupProject(root) {
+  const projectDir = path.join(root, BARODOC_DIR);
+  if (fs.existsSync(projectDir)) {
+    await fs.remove(projectDir);
+  }
+}
+function generateAstroConfigFile(config) {
+  const siteLine = config.site ? `
+  site: ${JSON.stringify(config.site)},` : "";
+  const baseLine = config.base ? `
+  base: ${JSON.stringify(config.base)},` : "";
+  return `import { defineConfig } from "astro/config";
+import barodoc from "@barodoc/core";
+import docsTheme from "@barodoc/theme-docs/theme";
+
+export default defineConfig({${siteLine}${baseLine}
+  integrations: [
+    barodoc({
+      config: "./barodoc.config.json",
+      theme: docsTheme(),
+    }),
+  ],
+  vite: {
+    resolve: {
+      preserveSymlinks: true,
+    },
+    ssr: {
+      noExternal: true,
+    },
+  },
+});
+`;
+}
+function findDocsDir(root) {
+  const candidates = ["docs", "content", "src/content/docs"];
+  for (const candidate of candidates) {
+    const fullPath = path.join(root, candidate);
+    if (fs.existsSync(fullPath)) {
+      return candidate;
+    }
+  }
+  return "docs";
+}
+
+export {
+  isCustomProject,
+  loadProjectConfig,
+  createProject,
+  cleanupProject,
+  generateAstroConfigFile,
+  findDocsDir
+};

package/dist/cli.js

@@ -3,22 +3,26 @@ import {
   cleanupProject,
   createProject,
   findDocsDir,
-  installDependencies,
+  generateAstroConfigFile,
   isCustomProject,
-  loadProjectConfig,
-  version
-} from "./chunk-G25BMQMN.js";
+  loadProjectConfig
+} from "./chunk-EFTFHBH3.js";
 
 // src/cli.ts
 import cac from "cac";
 import pc10 from "picocolors";
 
+// package.json
+var version = "8.0.0";
+
 // src/commands/serve.ts
 import path from "path";
 import pc from "picocolors";
-import { execa } from "execa";
+import { dev } from "astro";
+import barodoc from "@barodoc/core";
+import docsTheme from "@barodoc/theme-docs/theme";
 async function serve(dir, options) {
-  const root = path.resolve(process.cwd(), dir);
+  const root = path.resolve(process.cwd());
   console.log();
   console.log(pc.bold(pc.cyan("  barodoc serve")));
   console.log();
@@ -26,11 +30,16 @@ async function serve(dir, options) {
     console.log(pc.dim("Detected custom Astro project"));
     console.log(pc.dim("Running astro dev..."));
     console.log();
-    await runAstroDev(root, options);
+    const devServer2 = await dev({ root });
+    process.on("SIGINT", async () => {
+      console.log();
+      console.log(pc.dim("Shutting down..."));
+      await devServer2.stop();
+    });
     return;
   }
   console.log(pc.dim("Quick mode - creating temporary project..."));
-  const docsDir = findDocsDir(root);
+  const docsDir = dir || findDocsDir(root);
   const { config } = await loadProjectConfig(root, options.config);
   const projectDir = await createProject({
     root,
@@ -38,44 +47,50 @@ async function serve(dir, options) {
     config,
     configPath: options.config
   });
-  console.log(pc.green("\u2713 Project created"));
+  console.log(pc.green("\u2713 Project ready"));
   console.log();
-  await installDependencies(projectDir, options.clean);
-  await runAstroDev(projectDir, options);
-}
-async function runAstroDev(projectDir, options) {
-  const args = ["astro", "dev"];
-  if (options.port) {
-    args.push("--port", String(options.port));
-  }
-  if (options.host) {
-    args.push("--host");
-  }
-  if (options.open) {
-    args.push("--open");
-  }
-  try {
-    await execa("npx", args, {
-      cwd: projectDir,
-      stdio: "inherit"
-    });
-  } catch (error) {
-    if (error.signal === "SIGINT") {
-      console.log();
-      console.log(pc.dim("Shutting down..."));
-    } else {
-      throw error;
-    }
-  }
+  const devServer = await dev({
+    root: projectDir,
+    configFile: false,
+    integrations: [
+      barodoc({
+        config: "./barodoc.config.json",
+        theme: docsTheme()
+      })
+    ],
+    vite: {
+      resolve: {
+        preserveSymlinks: true
+      },
+      ssr: {
+        noExternal: [/^@barodoc\//]
+      }
+    },
+    server: {
+      port: options.port,
+      host: options.host ? true : void 0,
+      open: options.open
+    },
+    ...config.site ? { site: config.site } : {},
+    ...config.base ? { base: config.base } : {}
+  });
+  process.on("SIGINT", async () => {
+    console.log();
+    console.log(pc.dim("Shutting down..."));
+    await devServer.stop();
+  });
 }
 
 // src/commands/build.ts
 import path2 from "path";
 import pc2 from "picocolors";
 import fs from "fs-extra";
-import { execa as execa2 } from "execa";
+import { execa } from "execa";
+import { build as astroBuild } from "astro";
+import barodoc2 from "@barodoc/core";
+import docsTheme2 from "@barodoc/theme-docs/theme";
 async function build(dir, options) {
-  const root = path2.resolve(process.cwd(), dir);
+  const root = path2.resolve(process.cwd());
   const outputDir = path2.resolve(process.cwd(), options.output);
   console.log();
   console.log(pc2.bold(pc2.cyan("  barodoc build")));
@@ -84,11 +99,11 @@ async function build(dir, options) {
     console.log(pc2.dim("Detected custom Astro project"));
     console.log(pc2.dim("Running astro build..."));
     console.log();
-    await runAstroBuild(root, outputDir);
+    await astroBuild({ root });
     return;
   }
   console.log(pc2.dim("Quick mode - creating temporary project..."));
-  const docsDir = findDocsDir(root);
+  const docsDir = dir || findDocsDir(root);
   const { config } = await loadProjectConfig(root, options.config);
   const projectDir = await createProject({
     root,
@@ -96,11 +111,43 @@ async function build(dir, options) {
     config,
     configPath: options.config
   });
-  console.log(pc2.green("\u2713 Project created"));
+  console.log(pc2.green("\u2713 Project ready"));
   console.log();
-  await installDependencies(projectDir, options.clean);
   try {
-    await runAstroBuild(projectDir, path2.join(projectDir, "dist"));
+    console.log(pc2.dim("Building site..."));
+    await astroBuild({
+      root: projectDir,
+      configFile: false,
+      integrations: [
+        barodoc2({
+          config: "./barodoc.config.json",
+          theme: docsTheme2()
+        })
+      ],
+      vite: {
+        resolve: {
+          preserveSymlinks: true
+        },
+        ssr: {
+          noExternal: true
+        }
+      },
+      logLevel: "info",
+      ...config.site ? { site: config.site } : {},
+      ...config.base ? { base: config.base } : {}
+    });
+    console.log();
+    console.log(pc2.dim("Generating search index..."));
+    try {
+      await execa("npx", ["pagefind", "--site", "dist"], {
+        cwd: projectDir,
+        stdio: "inherit"
+      });
+    } catch {
+      console.log(
+        pc2.yellow("\u26A0 Pagefind not available, skipping search index")
+      );
+    }
     const tempDist = path2.join(projectDir, "dist");
     if (await fs.pathExists(tempDist)) {
       await fs.ensureDir(outputDir);
@@ -119,23 +166,6 @@ async function build(dir, options) {
   console.log(`  ${pc2.dim("Preview:")} barodoc preview ${dir}`);
   console.log();
 }
-async function runAstroBuild(projectDir, outputDir) {
-  console.log(pc2.dim("Building site..."));
-  await execa2("npx", ["astro", "build"], {
-    cwd: projectDir,
-    stdio: "inherit"
-  });
-  console.log();
-  console.log(pc2.dim("Generating search index..."));
-  try {
-    await execa2("npx", ["pagefind", "--site", "dist"], {
-      cwd: projectDir,
-      stdio: "inherit"
-    });
-  } catch {
-    console.log(pc2.yellow("\u26A0 Pagefind not available, skipping search index"));
-  }
-}
 
 // src/commands/create.ts
 import path3 from "path";
@@ -547,7 +577,7 @@ node_modules/
 import path4 from "path";
 import pc4 from "picocolors";
 import fs3 from "fs-extra";
-import { execa as execa3 } from "execa";
+import { preview as astroPreview } from "astro";
 async function preview(dir, options) {
   const root = path4.resolve(process.cwd(), dir);
   const distDir = path4.resolve(root, options.output);
@@ -565,22 +595,17 @@ async function preview(dir, options) {
   }
   console.log(pc4.dim(`Serving from ${options.output}/`));
   console.log();
-  try {
-    await execa3(
-      "npx",
-      ["serve", distDir, "-l", String(options.port)],
-      {
-        stdio: "inherit"
-      }
-    );
-  } catch (error) {
-    if (error.signal === "SIGINT") {
-      console.log();
-      console.log(pc4.dim("Shutting down..."));
-    } else {
-      throw error;
+  const previewServer = await astroPreview({
+    root,
+    server: {
+      port: options.port
     }
-  }
+  });
+  process.on("SIGINT", async () => {
+    console.log();
+    console.log(pc4.dim("Shutting down..."));
+    await previewServer.stop();
+  });
 }
 
 // src/commands/init.ts
@@ -722,7 +747,7 @@ barodoc preview
 import path6 from "path";
 import pc6 from "picocolors";
 import fs5 from "fs-extra";
-var BARODOC_DIR = ".barodoc";
+import { execa as execa2 } from "execa";
 async function eject(dir, options) {
   const root = path6.resolve(process.cwd(), dir);
   console.log();
@@ -773,17 +798,28 @@ async function eject(dir, options) {
     configPath: options.config
   });
   console.log(pc6.green("\u2713 Generated project files"));
-  await installDependencies(projectDir);
-  const astroConfigSrc = path6.join(projectDir, "astro.config.mjs");
-  let astroConfigContent = await fs5.readFile(astroConfigSrc, "utf-8");
-  await fs5.writeFile(path6.join(root, "astro.config.mjs"), astroConfigContent);
+  await fs5.writeFile(
+    path6.join(root, "astro.config.mjs"),
+    generateAstroConfigFile(config)
+  );
   console.log(pc6.green("\u2713 Created astro.config.mjs"));
   await fs5.copy(
     path6.join(projectDir, "tsconfig.json"),
     path6.join(root, "tsconfig.json")
   );
   console.log(pc6.green("\u2713 Created tsconfig.json"));
-  const tempPkg = await fs5.readJSON(path6.join(projectDir, "package.json"));
+  const runtimeDeps = {
+    astro: "^5.0.0",
+    "@astrojs/mdx": "^4.0.0",
+    "@astrojs/react": "^4.0.0",
+    "@barodoc/core": "latest",
+    "@barodoc/theme-docs": "latest",
+    "@tailwindcss/typography": "^0.5.19",
+    "@tailwindcss/vite": "^4.0.0",
+    tailwindcss: "^4.0.0",
+    react: "^19.0.0",
+    "react-dom": "^19.0.0"
+  };
   const rootPkgPath = path6.join(root, "package.json");
   if (await fs5.pathExists(rootPkgPath)) {
     const existingPkg = await fs5.readJSON(rootPkgPath);
@@ -792,7 +828,7 @@ async function eject(dir, options) {
       type: "module",
       dependencies: {
         ...existingPkg.dependencies ?? {},
-        ...tempPkg.dependencies
+        ...runtimeDeps
       }
     };
     await fs5.writeJSON(rootPkgPath, merged, { spaces: 2 });
@@ -807,7 +843,7 @@ async function eject(dir, options) {
         build: "astro build",
         preview: "astro preview"
       },
-      dependencies: tempPkg.dependencies
+      dependencies: runtimeDeps
     };
     await fs5.writeJSON(rootPkgPath, newPkg, { spaces: 2 });
     console.log(pc6.green("\u2713 Created package.json"));
@@ -819,19 +855,12 @@ async function eject(dir, options) {
     await fs5.copy(contentConfigSrc, contentConfigDst);
     console.log(pc6.green("\u2713 Created src/content/config.ts"));
   }
-  const srcNodeModules = path6.join(projectDir, "node_modules");
-  const dstNodeModules = path6.join(root, "node_modules");
-  if (await fs5.pathExists(srcNodeModules)) {
-    if (!await fs5.pathExists(dstNodeModules)) {
-      console.log(pc6.dim("Moving node_modules to project root..."));
-      await fs5.move(srcNodeModules, dstNodeModules);
-      console.log(pc6.green("\u2713 Moved node_modules"));
-    } else {
-      console.log(pc6.dim("node_modules already exists in root, skipping move"));
-    }
-  }
-  await fs5.remove(path6.join(root, BARODOC_DIR));
+  await cleanupProject(root);
   console.log(pc6.green("\u2713 Removed .barodoc/ directory"));
+  console.log();
+  console.log(pc6.dim("Installing dependencies..."));
+  await execa2("npm", ["install"], { cwd: root, stdio: "inherit" });
+  console.log(pc6.green("\u2713 Dependencies installed"));
   const gitignorePath = path6.join(root, ".gitignore");
   if (await fs5.pathExists(gitignorePath)) {
     const content = await fs5.readFile(gitignorePath, "utf-8");

package/dist/index.d.ts

@@ -8,11 +8,13 @@ interface ProjectOptions {
     configPath?: string;
 }
 /**
- * Create temporary Astro project for quick mode
+ * Create temporary Astro project for quick mode.
+ * Only generates config files and content symlinks — no node_modules needed.
+ * Astro is invoked programmatically from the CLI process.
  */
 declare function createProject(options: ProjectOptions): Promise<string>;
 /**
- * Clean up temporary project files but preserve node_modules cache and version marker.
+ * Clean up temporary project (remove everything).
  */
 declare function cleanupProject(root: string): Promise<void>;
 

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   cleanupProject,
   createProject
-} from "./chunk-G25BMQMN.js";
+} from "./chunk-EFTFHBH3.js";
 
 // src/index.ts
 export * from "@barodoc/core";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "barodoc",
-  "version": "7.2.0",
+  "version": "8.0.0",
   "description": "Documentation framework powered by Astro",
   "type": "module",
   "bin": {
@@ -18,6 +18,14 @@
     "dist"
   ],
   "dependencies": {
+    "astro": "^5.0.0",
+    "@astrojs/mdx": "^4.0.0",
+    "@astrojs/react": "^4.0.0",
+    "@tailwindcss/typography": "^0.5.19",
+    "@tailwindcss/vite": "^4.0.0",
+    "tailwindcss": "^4.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
     "cac": "^6.7.14",
     "chokidar": "^4.0.0",
     "execa": "^9.5.0",
@@ -26,8 +34,17 @@
     "picocolors": "^1.1.1",
     "zod": "^3.24.0",
     "zod-to-json-schema": "^3.25.1",
-    "@barodoc/theme-docs": "7.1.1",
-    "@barodoc/core": "7.0.0"
+    "@barodoc/core": "8.0.0",
+    "@barodoc/theme-docs": "8.0.0",
+    "@barodoc/plugin-analytics": "8.0.0",
+    "@barodoc/plugin-docsearch": "8.0.0",
+    "@barodoc/plugin-llms-txt": "8.0.0",
+    "@barodoc/plugin-og-image": "7.0.0",
+    "@barodoc/plugin-openapi": "8.0.0",
+    "@barodoc/plugin-pwa": "8.0.0",
+    "@barodoc/plugin-rss": "8.0.0",
+    "@barodoc/plugin-search": "8.0.0",
+    "@barodoc/plugin-sitemap": "8.0.0"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",

package/dist/chunk-G25BMQMN.js

@@ -1,255 +0,0 @@
-// package.json
-var version = "7.2.0";
-
-// src/runtime/project.ts
-import fs from "fs-extra";
-import path from "path";
-import pc from "picocolors";
-import { execa } from "execa";
-var BARODOC_DIR = ".barodoc";
-var CLI_VERSION_FILE = ".cli-version";
-function isCustomProject(dir) {
-  return fs.existsSync(path.join(dir, "astro.config.mjs")) || fs.existsSync(path.join(dir, "astro.config.ts")) || fs.existsSync(path.join(dir, "astro.config.js"));
-}
-async function loadProjectConfig(dir, configFile) {
-  const configPath = configFile ? path.resolve(dir, configFile) : path.join(dir, "barodoc.config.json");
-  if (fs.existsSync(configPath)) {
-    const content = await fs.readFile(configPath, "utf-8");
-    return {
-      config: JSON.parse(content),
-      configPath
-    };
-  }
-  return {
-    config: getDefaultConfig(),
-    configPath: null
-  };
-}
-function getDefaultConfig() {
-  return {
-    name: "Documentation",
-    navigation: [],
-    i18n: {
-      defaultLocale: "en",
-      locales: ["en"]
-    },
-    search: {
-      enabled: true
-    }
-  };
-}
-async function createProject(options) {
-  const { root, docsDir, config, configPath } = options;
-  const projectDir = path.join(root, BARODOC_DIR);
-  console.log(pc.dim(`Creating temporary project in ${BARODOC_DIR}/`));
-  const nodeModulesDir = path.join(projectDir, "node_modules");
-  const hasNodeModules = fs.existsSync(nodeModulesDir);
-  if (hasNodeModules) {
-    const preserve = /* @__PURE__ */ new Set(["node_modules", CLI_VERSION_FILE]);
-    const entries = await fs.readdir(projectDir);
-    for (const entry of entries) {
-      if (!preserve.has(entry)) {
-        await fs.remove(path.join(projectDir, entry));
-      }
-    }
-  } else {
-    await fs.remove(projectDir);
-    await fs.ensureDir(projectDir);
-  }
-  await fs.writeJSON(
-    path.join(projectDir, "package.json"),
-    {
-      name: "barodoc-temp",
-      type: "module",
-      private: true,
-      dependencies: {
-        astro: "^5.0.0",
-        "@astrojs/mdx": "^4.0.0",
-        "@astrojs/react": "^4.0.0",
-        "@tailwindcss/typography": "^0.5.19",
-        "@tailwindcss/vite": "^4.0.0",
-        tailwindcss: "^4.0.0",
-        "@barodoc/core": `^${version.split(".")[0]}.0.0`,
-        "@barodoc/theme-docs": `^${version.split(".")[0]}.0.0`,
-        react: "^19.0.0",
-        "react-dom": "^19.0.0"
-      }
-    },
-    { spaces: 2 }
-  );
-  const astroConfig = generateAstroConfig(config, configPath || null, docsDir);
-  await fs.writeFile(path.join(projectDir, "astro.config.mjs"), astroConfig);
-  await fs.writeJSON(
-    path.join(projectDir, "tsconfig.json"),
-    {
-      extends: "astro/tsconfigs/strict",
-      compilerOptions: {
-        jsx: "react-jsx",
-        jsxImportSource: "react"
-      }
-    },
-    { spaces: 2 }
-  );
-  const tempConfigPath = path.join(projectDir, "barodoc.config.json");
-  await fs.writeJSON(tempConfigPath, config, { spaces: 2 });
-  const contentDir = path.join(projectDir, "src/content");
-  await fs.ensureDir(contentDir);
-  await fs.writeFile(
-    path.join(contentDir, "config.ts"),
-    generateContentConfig()
-  );
-  const docsAbsolute = path.resolve(root, docsDir);
-  const docsLink = path.join(contentDir, "docs");
-  if (fs.existsSync(docsAbsolute)) {
-    await fs.symlink(docsAbsolute, docsLink, "dir");
-  } else {
-    await fs.ensureDir(docsLink);
-  }
-  const publicDir = path.join(root, "public");
-  const publicLink = path.join(projectDir, "public");
-  if (fs.existsSync(publicDir)) {
-    await fs.symlink(publicDir, publicLink, "dir");
-  } else {
-    await fs.ensureDir(publicLink);
-  }
-  const overridesDir = path.join(root, "overrides");
-  const overridesLink = path.join(projectDir, "overrides");
-  if (fs.existsSync(overridesDir)) {
-    await fs.symlink(overridesDir, overridesLink, "dir");
-    console.log(pc.dim("  Linked overrides/ directory"));
-  }
-  return projectDir;
-}
-function needsReinstall(projectDir) {
-  const versionFile = path.join(projectDir, CLI_VERSION_FILE);
-  if (!fs.existsSync(versionFile)) return true;
-  const cached = fs.readFileSync(versionFile, "utf-8").trim();
-  return cached !== version;
-}
-function writeCLIVersion(projectDir) {
-  fs.writeFileSync(path.join(projectDir, CLI_VERSION_FILE), version);
-}
-async function installDependencies(projectDir, force = false) {
-  const nodeModulesDir = path.join(projectDir, "node_modules");
-  const hasNodeModules = fs.existsSync(nodeModulesDir);
-  const versionChanged = hasNodeModules && needsReinstall(projectDir);
-  if (versionChanged && !force) {
-    console.log(
-      pc.yellow(`Barodoc updated (\u2192 ${version}), reinstalling dependencies...`)
-    );
-    force = true;
-  }
-  if (!force && hasNodeModules) {
-    console.log(pc.dim("Using cached dependencies..."));
-    console.log();
-    return;
-  }
-  if (force && hasNodeModules) {
-    console.log(pc.dim("Clearing cached dependencies..."));
-    await fs.remove(nodeModulesDir);
-  }
-  console.log(pc.dim("Installing dependencies..."));
-  await execa("npm", ["install", "--prefer-offline"], {
-    cwd: projectDir,
-    stdio: "inherit"
-  });
-  writeCLIVersion(projectDir);
-  console.log(pc.green("\u2713 Dependencies installed"));
-  console.log();
-}
-async function cleanupProject(root) {
-  const projectDir = path.join(root, BARODOC_DIR);
-  if (!fs.existsSync(projectDir)) return;
-  const preserve = /* @__PURE__ */ new Set(["node_modules", CLI_VERSION_FILE]);
-  const entries = await fs.readdir(projectDir);
-  for (const entry of entries) {
-    if (!preserve.has(entry)) {
-      await fs.remove(path.join(projectDir, entry));
-    }
-  }
-}
-function generateAstroConfig(config, configPath, docsDir) {
-  const siteLine = config.site ? `
-  site: ${JSON.stringify(config.site)},` : "";
-  const baseLine = config.base ? `
-  base: ${JSON.stringify(config.base)},` : "";
-  return `import { defineConfig } from "astro/config";
-import barodoc from "@barodoc/core";
-import docsTheme from "@barodoc/theme-docs/theme";
-
-export default defineConfig({${siteLine}${baseLine}
-  integrations: [
-    barodoc({
-      config: "./barodoc.config.json",
-      theme: docsTheme(),
-    }),
-  ],
-});
-`;
-}
-function generateContentConfig() {
-  return `import { defineCollection, z } from "astro:content";
-
-const docsCollection = defineCollection({
-  type: "content",
-  schema: z.object({
-    title: z.string().optional(),
-    description: z.string().optional(),
-    tags: z.array(z.string()).optional(),
-    related: z.array(z.string()).optional(),
-    category: z.string().optional(),
-    api_reference: z.boolean().optional(),
-    difficulty: z.enum(["beginner", "intermediate", "advanced"]).optional(),
-    lastUpdated: z.date().optional(),
-  }),
-});
-
-const blogCollection = defineCollection({
-  type: "content",
-  schema: z.object({
-    title: z.string(),
-    description: z.string().optional(),
-    excerpt: z.string().optional(),
-    date: z.coerce.date().optional(),
-    author: z.string().optional(),
-    image: z.string().optional(),
-    tags: z.array(z.string()).optional(),
-  }),
-});
-
-const changelogCollection = defineCollection({
-  type: "content",
-  schema: z.object({
-    title: z.string().optional(),
-    version: z.string(),
-    date: z.coerce.date(),
-  }),
-});
-
-export const collections = {
-  docs: docsCollection,
-  blog: blogCollection,
-  changelog: changelogCollection,
-};
-`;
-}
-function findDocsDir(root) {
-  const candidates = ["docs", "content", "src/content/docs"];
-  for (const candidate of candidates) {
-    const fullPath = path.join(root, candidate);
-    if (fs.existsSync(fullPath)) {
-      return candidate;
-    }
-  }
-  return "docs";
-}
-
-export {
-  version,
-  isCustomProject,
-  loadProjectConfig,
-  createProject,
-  installDependencies,
-  cleanupProject,
-  findDocsDir
-};