@fumadocs/cli 0.1.0 → 0.2.0

package/dist/build/index.d.ts

@@ -1,5 +1,17 @@
 import * as ts_morph from 'ts-morph';
 
+type ImportPathMap = Record<string, string | {
+    type: 'component';
+    name: string;
+    file: string;
+    /**
+     * Registry of the component, refer to the current registry if not specified
+     */
+    registry?: string;
+} | {
+    type: 'dependency';
+    name: string;
+}>;
 interface Component {
     name: string;
     description?: string;
@@ -12,17 +24,9 @@ interface Component {
      */
     unlisted?: boolean;
     /**
-     * Map imported file paths
+     * Map imported file paths, extended from registry `mapImportPath` if defined.
      */
-    mapImportPath?: Record<string, string | {
-        type: 'component';
-        name: string;
-        file: string;
-        /**
-         * Registry of the component, refer to the current registry if not specified
-         */
-        registry?: string;
-    }>;
+    mapImportPath?: ImportPathMap;
 }
 type NamespaceType = 'components' | 'hooks' | 'lib';
 interface PackageJson {
@@ -52,6 +56,10 @@ interface Registry {
     tsconfigPath?: string;
     packageJson?: string | PackageJson;
     components: Component[];
+    /**
+     * Map import paths of components
+     */
+    mapImportPath?: ImportPathMap;
     dependencies?: Record<string, {
         type: 'runtime' | 'dev';
         version?: string;
@@ -122,4 +130,4 @@ declare function writeOutput(dir: string, out: Output, options?: {
     log?: boolean;
 }): Promise<void>;
 
-export { type Component, type ComponentBuilder, type DependencyInfo, type NamespaceType, type Output, type OutputComponent, type OutputFile, type OutputIndex, type PackageJson, type Registry, build, createComponentBuilder, writeOutput };
+export { type Component, type ComponentBuilder, type DependencyInfo, type ImportPathMap, type NamespaceType, type Output, type OutputComponent, type OutputFile, type OutputIndex, type PackageJson, type Registry, build, createComponentBuilder, writeOutput };

package/dist/build/index.js

@@ -1,34 +1,49 @@
 import {
   exists
-} from "../chunk-WBCEM7RC.js";
+} from "../chunk-DG6SFM2G.js";
 
 // src/build/index.ts
-import * as fs3 from "node:fs/promises";
-import * as path4 from "node:path";
+import * as fs3 from "fs/promises";
+import * as path4 from "path";
 import picocolors from "picocolors";
 
 // src/build/build-registry.ts
-import * as fs2 from "node:fs/promises";
-import * as path3 from "node:path";
+import * as fs2 from "fs/promises";
+import * as path3 from "path";
 
 // src/build/build-file.ts
-import * as path from "node:path";
+import * as path from "path";
+import { ts } from "ts-morph";
 async function buildFile(inputPath, outputPath, builder, comp, onReference) {
   const out = {
     imports: {},
     content: "",
     path: outputPath
   };
-  async function process2(specifier, getSpecifiedFile) {
+  const importMap = {
+    ...builder.registry.mapImportPath,
+    ...comp.mapImportPath
+  };
+  function process2(specifier, getSpecifiedFile) {
     let specifiedFile = getSpecifiedFile();
     if (!specifiedFile) return;
     const name = specifiedFile.isInNodeModules() ? builder.resolveDep(specifier.getLiteralValue()).name : path.relative(builder.registryDir, specifiedFile.getFilePath());
-    if (comp.mapImportPath && name in comp.mapImportPath) {
-      const resolver = comp.mapImportPath[name];
+    if (name in importMap) {
+      const resolver = importMap[name];
       if (typeof resolver === "string") {
         specifier.setLiteralValue(resolver);
         specifiedFile = getSpecifiedFile();
         if (!specifiedFile) return;
+      } else if (resolver.type === "dependency") {
+        const info = builder.resolveDep(resolver.name);
+        const value2 = onReference({
+          type: "dependency",
+          name: info.name,
+          version: info.version ?? "",
+          isDev: info.type === "dev"
+        });
+        if (value2) out.imports[specifier.getLiteralValue()] = value2;
+        return;
       } else {
         const sub2 = builder.getComponentByName(
           resolver.name,
@@ -80,7 +95,7 @@ async function buildFile(inputPath, outputPath, builder, comp, onReference) {
   }
   const sourceFile = await builder.createSourceFile(inputPath);
   for (const item of sourceFile.getImportDeclarations()) {
-    await process2(
+    process2(
       item.getModuleSpecifier(),
       () => item.getModuleSpecifierSourceFile()
     );
@@ -88,14 +103,25 @@ async function buildFile(inputPath, outputPath, builder, comp, onReference) {
   for (const item of sourceFile.getExportDeclarations()) {
     const specifier = item.getModuleSpecifier();
     if (!specifier) continue;
-    await process2(specifier, () => item.getModuleSpecifierSourceFile());
+    process2(specifier, () => item.getModuleSpecifierSourceFile());
+  }
+  const calls = sourceFile.getDescendantsOfKind(ts.SyntaxKind.CallExpression);
+  for (const expression of calls) {
+    if (expression.getExpression().isKind(ts.SyntaxKind.ImportKeyword) && expression.getArguments().length === 1) {
+      const argument = expression.getArguments()[0];
+      if (!argument.isKind(ts.SyntaxKind.StringLiteral)) continue;
+      process2(
+        argument,
+        () => argument.getSymbol()?.getDeclarations()[0].getSourceFile()
+      );
+    }
   }
   out.content = sourceFile.getFullText();
   return out;
 }
 
 // src/build/component-builder.ts
-import path2 from "node:path";
+import path2 from "path";
 import { Project } from "ts-morph";
 import * as fs from "fs/promises";
 function createComponentBuilder(registry, packageJson) {
@@ -254,7 +280,6 @@ async function buildComponent(component, builder) {
   const subComponents = /* @__PURE__ */ new Set();
   const devDependencies = /* @__PURE__ */ new Map();
   const dependencies = /* @__PURE__ */ new Map();
-  const files = [];
   async function build2(file) {
     let inputPath;
     let outputPath;
@@ -272,57 +297,54 @@ async function buildComponent(component, builder) {
       inputPath = path3.join(builder.registryDir, file.in);
       outputPath = file.out;
     }
-    if (processedFiles.has(inputPath)) return;
+    if (processedFiles.has(inputPath)) return [];
     processedFiles.add(inputPath);
     const queue = [];
-    files.push(
-      await buildFile(
-        inputPath,
-        outputPath,
-        builder,
-        component,
-        (reference) => {
-          if (reference.type === "file") {
-            queue.push(path3.relative(builder.registryDir, reference.file));
-            return builder.resolveOutputPath(reference.file);
+    const result = await buildFile(
+      inputPath,
+      outputPath,
+      builder,
+      component,
+      (reference) => {
+        if (reference.type === "file") {
+          queue.push(path3.relative(builder.registryDir, reference.file));
+          return builder.resolveOutputPath(reference.file);
+        }
+        if (reference.type === "sub-component") {
+          const resolved = reference.resolved;
+          subComponents.add(resolved.component.name);
+          if (resolved.type === "remote") {
+            return reference.targetFile;
           }
-          if (reference.type === "sub-component") {
-            const resolved = reference.resolved;
-            subComponents.add(resolved.component.name);
-            if (resolved.type === "remote") {
-              return reference.targetFile;
+          for (const childFile of resolved.component.files) {
+            if (typeof childFile === "string" && childFile === reference.targetFile) {
+              return builder.resolveOutputPath(
+                childFile,
+                reference.resolved.registryName
+              );
             }
-            for (const childFile of resolved.component.files) {
-              if (typeof childFile === "string" && childFile === reference.targetFile) {
-                return builder.resolveOutputPath(
-                  childFile,
-                  reference.resolved.registryName
-                );
-              }
-              if (typeof childFile === "object" && childFile.in === reference.targetFile) {
-                return childFile.out;
-              }
+            if (typeof childFile === "object" && childFile.in === reference.targetFile) {
+              return childFile.out;
             }
-            throw new Error(
-              `Failed to find sub component ${resolved.component.name}'s ${reference.targetFile} referenced by ${inputPath}`
-            );
-          }
-          if (reference.type === "dependency") {
-            if (reference.isDev)
-              devDependencies.set(reference.name, reference.version);
-            else dependencies.set(reference.name, reference.version);
           }
+          throw new Error(
+            `Failed to find sub component ${resolved.component.name}'s ${reference.targetFile} referenced by ${inputPath}`
+          );
+        }
+        if (reference.type === "dependency") {
+          if (reference.isDev)
+            devDependencies.set(reference.name, reference.version);
+          else dependencies.set(reference.name, reference.version);
         }
-      )
+      }
     );
-    await Promise.all(queue.map(build2));
+    return [result, ...(await Promise.all(queue.map(build2))).flat()];
   }
-  await Promise.all(component.files.map(build2));
   return [
     component,
     {
       name: component.name,
-      files,
+      files: (await Promise.all(component.files.map(build2))).flat(),
       subComponents: Array.from(subComponents),
       dependencies: Object.fromEntries(dependencies),
       devDependencies: Object.fromEntries(devDependencies)

package/dist/{chunk-WBCEM7RC.js → chunk-DG6SFM2G.js}

@@ -1,6 +1,6 @@
 // src/utils/fs.ts
-import fs from "node:fs/promises";
-import path from "node:path";
+import fs from "fs/promises";
+import path from "path";
 async function exists(pathLike) {
   try {
     await fs.access(pathLike);

package/dist/index.js

@@ -2,36 +2,29 @@
 import {
   exists,
   isRelative
-} from "./chunk-WBCEM7RC.js";
+} from "./chunk-DG6SFM2G.js";
 
 // src/index.ts
-import fs10 from "node:fs/promises";
-import path9 from "node:path";
+import fs10 from "fs/promises";
+import path9 from "path";
 import { Command } from "commander";
-import picocolors6 from "picocolors";
-import {
-  isCancel as isCancel3,
-  log as log6,
-  multiselect,
-  outro as outro2,
-  select as select2,
-  spinner as spinner3
-} from "@clack/prompts";
+import picocolors5 from "picocolors";
+import { isCancel as isCancel5, outro as outro4, select as select2 } from "@clack/prompts";
 
 // src/commands/init.ts
-import * as process2 from "node:process";
-import path3 from "node:path";
+import * as process2 from "process";
+import path3 from "path";
 import {
-  intro,
+  cancel,
   confirm,
+  intro,
   isCancel,
-  cancel,
-  spinner,
   log,
-  note
+  note,
+  spinner
 } from "@clack/prompts";
 import picocolors from "picocolors";
-import { execa } from "execa";
+import { x } from "tinyexec";
 
 // src/utils/get-package-manager.ts
 import { detect } from "package-manager-detector";
@@ -41,7 +34,7 @@ async function getPackageManager() {
 }
 
 // src/utils/is-src.ts
-import path from "node:path";
+import path from "path";
 async function isSrc() {
   return exists("./src");
 }
@@ -49,11 +42,8 @@ function resolveAppPath(filePath, src2) {
   return src2 ? path.join("./src", filePath) : filePath;
 }
 
-// src/utils/transform-references.ts
-import path2 from "node:path";
-
 // src/config.ts
-import fs from "node:fs/promises";
+import fs from "fs/promises";
 var src = await isSrc();
 var defaultConfig = {
   aliases: {
@@ -72,44 +62,23 @@ async function loadConfig(file = "./cli.json") {
   }
 }
 async function initConfig(file = "./cli.json") {
+  if (await fs.stat(file).then(() => true).catch(() => false)) {
+    return false;
+  }
   await fs.writeFile(file, JSON.stringify(defaultConfig, null, 2));
+  return true;
 }
 
+// src/utils/transform-references.ts
+import path2 from "path";
+
 // src/constants.ts
 var typescriptExtensions = [".ts", ".tsx", ".js", ".jsx"];
 
 // src/utils/transform-references.ts
-function getOutputPath(ref, config) {
-  if (path2.isAbsolute(ref)) throw new Error(`path cannot be absolute: ${ref}`);
-  if (ref === "utils/cn" || ref === "utils/cn.ts") {
-    return config.aliases?.cn ?? defaultConfig.aliases.cn;
-  }
-  if (ref.startsWith("components")) {
-    return path2.join(
-      config.aliases?.componentsDir ?? defaultConfig.aliases.componentsDir,
-      path2.relative("components", ref)
-    );
-  }
-  if (ref.startsWith("lib") || ref.startsWith("utils")) {
-    return path2.join(
-      config.aliases?.libDir ?? defaultConfig.aliases.libDir,
-      path2.relative("lib", ref)
-    );
-  }
-  return ref;
-}
-async function transformReferences(file, resolver, transform) {
-  for (const item of file.getImportDeclarations()) {
-    const ref = item.getModuleSpecifier().getLiteralValue();
-    const result = await transform(resolveReference(ref, resolver), ref);
-    if (!result) continue;
-    item.getModuleSpecifier().setLiteralValue(result);
-  }
-  for (const item of file.getExportDeclarations()) {
-    const specifier = item.getModuleSpecifier();
-    if (!specifier) continue;
-    const ref = specifier.getLiteralValue();
-    const result = await transform(resolveReference(ref, resolver), ref);
+function transformReferences(file, transform) {
+  for (const specifier of file.getImportStringLiterals()) {
+    const result = transform(specifier.getLiteralValue());
     if (!result) continue;
     specifier.setLiteralValue(result);
   }
@@ -195,20 +164,17 @@ async function init(plugin, config = {}) {
     const sourceFile = project.createSourceFile(file, content, {
       overwrite: true
     });
-    await transformReferences(
-      sourceFile,
-      {
+    transformReferences(sourceFile, (specifier) => {
+      const resolved = resolveReference(specifier, {
         alias: {
           type: "append",
           dir: ctx.src ? "src" : ""
         },
         relativeTo: path3.dirname(file)
-      },
-      (resolved) => {
-        if (resolved.type !== "file") return;
-        return toReferencePath(file, getOutputPath(resolved.path, ctx));
-      }
-    );
+      });
+      if (resolved.type !== "file") return;
+      return toReferencePath(file, getOutputPath(resolved.path, ctx));
+    });
     await sourceFile.save();
   }
   if (plugin.dependencies.length > 0) {
@@ -223,7 +189,7 @@ async function init(plugin, config = {}) {
     if (value) {
       const spin = spinner();
       spin.start("Installing dependencies");
-      await execa(manager, ["install", ...plugin.dependencies]);
+      await x(manager, ["install", ...plugin.dependencies]);
       spin.stop("Successfully installed.");
     }
   }
@@ -261,76 +227,38 @@ prettier . --write`,
     }
   }
 }
-
-// src/commands/add.ts
-import path4 from "node:path";
-import fs3 from "node:fs/promises";
-import { log as log2, confirm as confirm2, isCancel as isCancel2, outro, spinner as spinner2, intro as intro2 } from "@clack/prompts";
-import picocolors2 from "picocolors";
-import { execa as execa2 } from "execa";
-
-// src/utils/add/get-dependencies.ts
-import fs2 from "node:fs/promises";
-async function getDependencies() {
-  const dependencies = /* @__PURE__ */ new Map();
-  if (!await exists("package.json")) return dependencies;
-  const content = await fs2.readFile("package.json");
-  const parsed = JSON.parse(content.toString());
-  if ("dependencies" in parsed && typeof parsed.dependencies === "object") {
-    const records = parsed.dependencies;
-    Object.entries(records).forEach(([k, v]) => {
-      dependencies.set(k, v);
-    });
+function getOutputPath(ref, config) {
+  if (path3.isAbsolute(ref)) throw new Error(`path cannot be absolute: ${ref}`);
+  if (ref === "utils/cn" || ref === "utils/cn.ts") {
+    return config.aliases?.cn ?? defaultConfig.aliases.cn;
   }
-  if ("devDependencies" in parsed && typeof parsed.devDependencies === "object") {
-    const records = parsed.devDependencies;
-    Object.entries(records).forEach(([k, v]) => {
-      dependencies.set(k, v);
-    });
+  if (ref.startsWith("components")) {
+    return path3.join(
+      config.aliases?.componentsDir ?? defaultConfig.aliases.componentsDir,
+      path3.relative("components", ref)
+    );
   }
-  return dependencies;
+  if (ref.startsWith("lib") || ref.startsWith("utils")) {
+    return path3.join(
+      config.aliases?.libDir ?? defaultConfig.aliases.libDir,
+      path3.relative("lib", ref)
+    );
+  }
+  return ref;
 }
 
-// src/commands/add.ts
+// src/utils/add/install-component.ts
+import path4 from "path";
+import fs2 from "fs/promises";
+import { confirm as confirm2, isCancel as isCancel2, log as log2, outro } from "@clack/prompts";
 var downloadedFiles = /* @__PURE__ */ new Set();
-async function add(name, resolver, config = {}) {
-  intro2(
-    picocolors2.bold(
-      picocolors2.inverse(picocolors2.cyanBright(`Add Component: ${name}`))
-    )
-  );
+async function installComponent(name, resolver, config = {}) {
   const project = createEmptyProject();
-  const result = await downloadComponent(name, {
+  return downloadComponent(name, {
     project,
     config,
     resolver
   });
-  if (!result) {
-    log2.error(`Component: ${name} not found`);
-    process.exit(0);
-  }
-  const installed = await getDependencies();
-  const deps = Object.entries(result.dependencies).filter(([k]) => !installed.has(k)).map(([k, v]) => v.length === 0 ? k : `${k}@${v}`);
-  const devDeps = Object.entries(result.devDependencies).filter(([k]) => !installed.has(k)).map(([k, v]) => v.length === 0 ? k : `${k}@${v}`);
-  if (deps.length > 0 || devDeps.length > 0) {
-    const manager = await getPackageManager();
-    const value = await confirm2({
-      message: `This component requires dependencies (${[...deps, ...devDeps].join(" ")}), install them with ${manager}?`
-    });
-    if (isCancel2(value)) {
-      outro(picocolors2.bold(picocolors2.greenBright("Component downloaded")));
-      process.exit(0);
-    }
-    if (value) {
-      const spin = spinner2();
-      spin.start("Installing dependencies...");
-      if (deps.length > 0) await execa2(manager, ["install", ...deps]);
-      if (devDeps.length > 0)
-        await execa2(manager, ["install", ...devDeps, "-D"]);
-      spin.stop("Dependencies installed.");
-    }
-  }
-  outro(picocolors2.bold(picocolors2.greenBright("Component installed")));
 }
 var downloadedComps = /* @__PURE__ */ new Map();
 async function downloadComponent(name, ctx) {
@@ -344,7 +272,7 @@ async function downloadComponent(name, ctx) {
     const outPath = resolveOutputPath(file.path, ctx.config);
     const output = typescriptExtensions.includes(path4.extname(file.path)) ? transformTypeScript(outPath, file, ctx) : file.content;
     let canWrite = true;
-    const requireOverride = await fs3.readFile(outPath).then((res) => res.toString() !== output).catch(() => false);
+    const requireOverride = await fs2.readFile(outPath).then((res) => res.toString() !== output).catch(() => false);
     if (requireOverride) {
       const value = await confirm2({
         message: `Do you want to override ${outPath}?`
@@ -356,8 +284,8 @@ async function downloadComponent(name, ctx) {
       canWrite = value;
     }
     if (canWrite) {
-      await fs3.mkdir(path4.dirname(outPath), { recursive: true });
-      await fs3.writeFile(outPath, output);
+      await fs2.mkdir(path4.dirname(outPath), { recursive: true });
+      await fs2.writeFile(outPath, output);
       log2.step(`downloaded ${outPath}`);
     }
     downloadedFiles.add(file.path);
@@ -389,22 +317,12 @@ function transformTypeScript(filePath, file, ctx) {
   const sourceFile = ctx.project.createSourceFile(filePath, file.content, {
     overwrite: true
   });
-  for (const item of sourceFile.getImportDeclarations()) {
-    const ref = item.getModuleSpecifier().getLiteralValue();
-    if (ref in file.imports) {
-      const outputPath = resolveOutputPath(file.imports[ref], ctx.config);
-      item.getModuleSpecifier().setLiteralValue(toReferencePath(filePath, outputPath));
-    }
-  }
-  for (const item of sourceFile.getExportDeclarations()) {
-    const specifier = item.getModuleSpecifier();
-    if (!specifier) continue;
-    const ref = specifier.getLiteralValue();
-    if (ref in file.imports) {
-      const outputPath = resolveOutputPath(file.imports[ref], ctx.config);
-      specifier.setLiteralValue(toReferencePath(filePath, outputPath));
+  transformReferences(sourceFile, (specifier) => {
+    if (specifier in file.imports) {
+      const outputPath = resolveOutputPath(file.imports[specifier], ctx.config);
+      return toReferencePath(filePath, outputPath);
     }
-  }
+  });
   return sourceFile.getFullText();
 }
 function remoteResolver(url) {
@@ -416,75 +334,24 @@ function remoteResolver(url) {
 }
 function localResolver(dir) {
   return async (file) => {
-    return await fs3.readFile(path4.join(dir, file)).then((res) => JSON.parse(res.toString())).catch(() => void 0);
+    return await fs2.readFile(path4.join(dir, file)).then((res) => JSON.parse(res.toString())).catch(() => void 0);
   };
 }
 
-// src/plugins/og-image.ts
-import picocolors3 from "picocolors";
-
-// src/generated.js
-var generated = { "lib/metadata": "import { createMetadataImage } from 'fumadocs-core/server';\nimport { source } from '@/lib/source';\n\nexport const metadataImage = createMetadataImage({\n  imageRoute: '/docs-og',\n  source,\n});\n", "app/docs-og/[...slug]/route": "import { generateOGImage } from 'fumadocs-ui/og';\nimport { metadataImage } from '@/lib/metadata';\n\nexport const GET = metadataImage.createAPI((page) => {\n  return generateOGImage({\n    title: page.data.title,\n    description: page.data.description,\n    site: 'My App',\n  });\n});\n\nexport function generateStaticParams() {\n  return metadataImage.generateParams();\n}\n", "lib/i18n": "import type { I18nConfig } from 'fumadocs-core/i18n';\n\nexport const i18n: I18nConfig = {\n  defaultLanguage: 'en',\n  languages: ['en', 'cn'],\n};\n", "middleware": "import { createI18nMiddleware } from 'fumadocs-core/i18n';\nimport { i18n } from '@/lib/i18n';\n\nexport default createI18nMiddleware(i18n);\n\nexport const config = {\n  // Matcher ignoring `/_next/` and `/api/`\n  matcher: ['/((?!api|_next/static|_next/image|favicon.ico).*)'],\n};\n", "scripts/generate-docs": "import * as OpenAPI from 'fumadocs-openapi';\nimport { rimrafSync } from 'rimraf';\n\nconst out = './content/docs/(api)';\n\n// clean generated files\nrimrafSync(out, {\n  filter(v) {\n    return !v.endsWith('index.mdx') && !v.endsWith('meta.json');\n  },\n});\n\nvoid OpenAPI.generateFiles({\n  // input files\n  input: ['./openapi.json'],\n  output: out,\n  groupBy: 'tag',\n});\n" };
-
-// src/plugins/og-image.ts
-function isI18nEnabled(ctx) {
-  return exists(getOutputPath("lib/i18n.ts", ctx));
-}
-var ogImagePlugin = {
-  files: async (ctx) => {
-    const route = await isI18nEnabled(ctx) ? "app/[lang]/docs-og/[...slug]/route.tsx" : "app/docs-og/[...slug]/route.tsx";
-    return {
-      "lib/metadata.ts": generated["lib/metadata"],
-      [ctx.src ? `src/${route}` : route]: generated["app/docs-og/[...slug]/route"]
-    };
-  },
-  dependencies: [],
-  instructions: (ctx) => [
-    {
-      type: "text",
-      text: picocolors3.cyanBright(picocolors3.bold("Import the utils like:"))
-    },
-    {
-      type: "code",
-      title: "ts",
-      code: 'import { metadataImage } from "@/lib/metadata";'
-    },
-    {
-      type: "text",
-      text: picocolors3.cyanBright(
-        picocolors3.bold("Add the images to your metadata:")
-      )
-    },
-    {
-      type: "code",
-      title: resolveAppPath("app/docs/[[...slug]]/page.tsx", ctx.src),
-      code: `
-export function generateMetadata({ params }: { params: { slug?: string[] } }) {
-  const page = source.getPage(params.slug);
-
-  if (!page) notFound();
-
-  ${picocolors3.bold(picocolors3.underline("return metadataImage.withImage(page.slugs, {"))}
-    title: page.data.title,
-    description: page.data.description,
-  });
-}
-`.trim()
-    }
-  ]
-};
-
 // src/plugins/i18n.ts
-import path7 from "node:path";
+import path7 from "path";
 import { log as log3 } from "@clack/prompts";
 
+// src/generated.js
+var generated = { "lib/i18n": "import type { I18nConfig } from 'fumadocs-core/i18n';\n\nexport const i18n: I18nConfig = {\n  defaultLanguage: 'en',\n  languages: ['en', 'cn'],\n};\n", "middleware": "import { createI18nMiddleware } from 'fumadocs-core/i18n';\nimport { i18n } from '@/lib/i18n';\n\nexport default createI18nMiddleware(i18n);\n\nexport const config = {\n  // Matcher ignoring `/_next/` and `/api/`\n  matcher: ['/((?!api|_next/static|_next/image|favicon.ico).*)'],\n};\n", "scripts/generate-docs": "import * as OpenAPI from 'fumadocs-openapi';\nimport { rimraf } from 'rimraf';\n\nconst out = './content/docs/(api)';\n\nasync function generate() {\n  // clean generated files\n  await rimraf(out, {\n    filter(v) {\n      return !v.endsWith('index.mdx') && !v.endsWith('meta.json');\n    },\n  });\n\n  await OpenAPI.generateFiles({\n    // input files\n    input: ['./openapi.json'],\n    output: out,\n  });\n}\n\nvoid generate();\n" };
+
 // src/utils/i18n/transform-layout-config.ts
-import fs4 from "node:fs/promises";
+import fs3 from "fs/promises";
 import { SyntaxKind } from "ts-morph";
 async function transformLayoutConfig(project, filePath) {
   let content;
   try {
-    content = await fs4.readFile(filePath).then((res) => res.toString());
+    content = await fs3.readFile(filePath).then((res) => res.toString());
   } catch {
     return;
   }
@@ -506,18 +373,18 @@ async function transformLayoutConfig(project, filePath) {
 }
 
 // src/utils/move-files.ts
-import fs5 from "node:fs/promises";
-import path5 from "node:path";
+import fs4 from "fs/promises";
+import path5 from "path";
 var transformExtensions = [".js", ".ts", ".tsx", ".jsx"];
 async function moveFiles(from, to, filter, project, src2, originalDir = from) {
   function isIncluded(file) {
     if (!transformExtensions.includes(path5.extname(file))) return false;
     return filter(path5.resolve(file));
   }
-  const stats = await fs5.lstat(from).catch(() => void 0);
+  const stats = await fs4.lstat(from).catch(() => void 0);
   if (!stats) return;
   if (stats.isDirectory()) {
-    const items = await fs5.readdir(from);
+    const items = await fs4.readdir(from);
     await Promise.all(
       items.map(async (item) => {
         await moveFiles(
@@ -530,46 +397,43 @@ async function moveFiles(from, to, filter, project, src2, originalDir = from) {
         );
       })
     );
-    await fs5.rmdir(from).catch(() => {
+    await fs4.rmdir(from).catch(() => {
     });
   }
-  if (!stats.isFile() || !await isIncluded(from)) return;
-  const content = await fs5.readFile(from);
+  if (!stats.isFile() || !isIncluded(from)) return;
+  const content = await fs4.readFile(from);
   const sourceFile = project.createSourceFile(from, content.toString(), {
     overwrite: true
   });
-  await transformReferences(
-    sourceFile,
-    {
+  transformReferences(sourceFile, (specifier) => {
+    const resolved = resolveReference(specifier, {
       alias: {
         type: "append",
         dir: src2 ? "src" : ""
       },
       relativeTo: path5.dirname(from)
-    },
-    async (resolved) => {
-      if (resolved.type !== "file") return;
-      if (
-        // ignore if the file is also moved
-        isRelative(originalDir, from) && await isIncluded(resolved.path)
-      )
-        return;
-      return toReferencePath(to, resolved.path);
-    }
-  );
+    });
+    if (resolved.type !== "file") return;
+    if (
+      // ignore if the file is also moved
+      isRelative(originalDir, from) && isIncluded(resolved.path)
+    )
+      return;
+    return toReferencePath(to, resolved.path);
+  });
   await sourceFile.save();
-  await fs5.mkdir(path5.dirname(to), { recursive: true });
-  await fs5.rename(from, to);
+  await fs4.mkdir(path5.dirname(to), { recursive: true });
+  await fs4.rename(from, to);
 }
 
 // src/utils/i18n/transform-source-i18n.ts
-import * as fs6 from "node:fs/promises";
-import path6 from "node:path";
+import * as fs5 from "fs/promises";
+import path6 from "path";
 import { StructureKind, SyntaxKind as SyntaxKind2 } from "ts-morph";
 async function transformSourceI18n(project, filePath, config) {
   let content;
   try {
-    content = await fs6.readFile(filePath).then((res) => res.toString());
+    content = await fs5.readFile(filePath).then((res) => res.toString());
   } catch {
     return;
   }
@@ -598,14 +462,14 @@ async function transformSourceI18n(project, filePath, config) {
 }
 
 // src/utils/i18n/transform-root-layout.ts
-import fs7 from "node:fs/promises";
+import fs6 from "fs/promises";
 import { StructureKind as StructureKind2, ts } from "ts-morph";
 var ScriptKind = ts.ScriptKind;
 var SyntaxKind3 = ts.SyntaxKind;
 async function transformRootLayout(project, filePath) {
   let content;
   try {
-    content = await fs7.readFile(filePath).then((res) => res.toString());
+    content = await fs6.readFile(filePath).then((res) => res.toString());
   } catch {
     return;
   }
@@ -647,7 +511,7 @@ function runTransform(sourceFile) {
 }
 
 // src/plugins/i18n.ts
-import picocolors4 from "picocolors";
+import picocolors2 from "picocolors";
 var i18nPlugin = {
   files: ({ src: src2 }) => ({
     "lib/i18n.ts": generated["lib/i18n"],
@@ -657,7 +521,7 @@ var i18nPlugin = {
   instructions: () => [
     {
       type: "title",
-      text: `1. Update the params of ${picocolors4.bold("page.tsx")} and ${picocolors4.bold("layout.tsx")}, and make them async if necessary.`
+      text: `1. Update the params of ${picocolors2.bold("page.tsx")} and ${picocolors2.bold("layout.tsx")}, and make them async if necessary.`
     },
     {
       type: "code",
@@ -666,7 +530,7 @@ var i18nPlugin = {
 export default async function Layout({
   params,
 }: {
-  ${picocolors4.underline(picocolors4.bold("params: Promise<{ lang: string }>"))}
+  ${picocolors2.underline(picocolors2.bold("params: Promise<{ lang: string }>"))}
 })
 `.trim()
     },
@@ -677,7 +541,7 @@ export default async function Layout({
 export default async function Page({
   params,
 }: {
-  ${picocolors4.underline(picocolors4.bold("params: Promise<{ lang: string; slug?: string[] }>"))}
+  ${picocolors2.underline(picocolors2.bold("params: Promise<{ lang: string; slug?: string[] }>"))}
 })
 `.trim()
     },
@@ -731,12 +595,12 @@ See https://nextjs.org/docs/app/building-your-application/routing/internationali
 };
 
 // src/plugins/openapi.ts
-import fs9 from "node:fs/promises";
-import path8 from "node:path";
+import fs8 from "fs/promises";
+import path8 from "path";
 import { StructureKind as StructureKind3 } from "ts-morph";
 
 // src/utils/transform-tailwind.ts
-import fs8 from "node:fs/promises";
+import fs7 from "fs/promises";
 import { SyntaxKind as SyntaxKind4 } from "ts-morph";
 import { log as log4 } from "@clack/prompts";
 var tailwindConfigPaths = [
@@ -762,7 +626,7 @@ async function transformTailwind(project, options) {
   }
   const configFile = project.createSourceFile(
     file,
-    await fs8.readFile(file).then((res) => res.toString()),
+    await fs7.readFile(file).then((res) => res.toString()),
     { overwrite: true }
   );
   const exports = configFile.getExportAssignments();
@@ -823,21 +687,21 @@ import { openapi } from '@/lib/source';
   ]
 };
 async function addScript() {
-  const content = await fs9.readFile("package.json");
+  const content = await fs8.readFile("package.json");
   const parsed = JSON.parse(content.toString());
   if (typeof parsed.scripts !== "object") return;
   parsed.scripts ??= {};
   Object.assign(parsed.scripts ?? {}, {
     "build:docs": "node ./scripts/generate-docs.mjs"
   });
-  await fs9.writeFile("package.json", JSON.stringify(parsed, null, 2));
+  await fs8.writeFile("package.json", JSON.stringify(parsed, null, 2));
 }
 async function transformSource(project, config) {
   const source = path8.join(
     config.aliases?.libDir ?? defaultConfig.aliases.libDir,
     "source.ts"
   );
-  const content = await fs9.readFile(source).catch(() => "");
+  const content = await fs8.readFile(source).catch(() => "");
   const file = project.createSourceFile(source, content.toString(), {
     overwrite: true
   });
@@ -852,7 +716,6 @@ async function transformSource(project, config) {
 
 // src/plugins/index.ts
 var plugins = {
-  "og-image": ogImagePlugin,
   i18n: i18nPlugin,
   openapi: openapiPlugin
 };
@@ -893,9 +756,9 @@ export default (${treeToMdx(input, noRoot)})`;
 }
 
 // src/utils/file-tree/run-tree.ts
-import { execa as execa3 } from "execa";
+import { x as x2 } from "tinyexec";
 async function runTree(args) {
-  const out = await execa3("tree", [args, "--gitignore", "--prune", "-J"]);
+  const out = await x2("tree", [args, "--gitignore", "--prune", "-J"]);
   try {
     return JSON.parse(out.stdout);
   } catch (e) {
@@ -908,7 +771,7 @@ async function runTree(args) {
 // package.json
 var package_default = {
   name: "@fumadocs/cli",
-  version: "0.1.0",
+  version: "0.2.0",
   description: "The CLI tool for Fumadocs",
   keywords: [
     "NextJs",
@@ -942,21 +805,19 @@ var package_default = {
     "types:check": "tsc --noEmit"
   },
   dependencies: {
-    "@clack/prompts": "^0.10.0",
-    commander: "^13.1.0",
-    execa: "^9.5.2",
-    "package-manager-detector": "^1.1.0",
+    "@clack/prompts": "^0.10.1",
+    commander: "^14.0.0",
+    "package-manager-detector": "^1.3.0",
     picocolors: "^1.1.1",
-    "ts-morph": "^25.0.1"
+    tinyexec: "^1.0.1",
+    "ts-morph": "^26.0.0"
   },
   devDependencies: {
-    "@types/cross-spawn": "^6.0.6",
-    "@types/node": "22.13.16",
-    "@types/react": "^19.0.12",
+    "@types/node": "22.15.19",
+    "@types/react": "^19.1.4",
     "eslint-config-custom": "workspace:*",
-    "fast-glob": "^3.3.3",
     tsconfig: "workspace:*",
-    tsx: "^4.19.3"
+    tsx: "^4.19.4"
   },
   publishConfig: {
     access: "public"
@@ -964,10 +825,136 @@ var package_default = {
 };
 
 // src/commands/customise.ts
-import { cancel as cancel2, group, intro as intro3, select, confirm as confirm3, log as log5 } from "@clack/prompts";
-import picocolors5 from "picocolors";
+import {
+  cancel as cancel2,
+  confirm as confirm4,
+  group,
+  intro as intro3,
+  log as log6,
+  outro as outro3,
+  select
+} from "@clack/prompts";
+import picocolors4 from "picocolors";
+
+// src/commands/add.ts
+import {
+  intro as intro2,
+  isCancel as isCancel4,
+  log as log5,
+  multiselect,
+  outro as outro2,
+  spinner as spinner3
+} from "@clack/prompts";
+import picocolors3 from "picocolors";
+
+// src/utils/add/install-deps.ts
+import { confirm as confirm3, isCancel as isCancel3, spinner as spinner2 } from "@clack/prompts";
+import { x as x3 } from "tinyexec";
+
+// src/utils/add/get-deps.ts
+import fs9 from "fs/promises";
+async function getDeps() {
+  const dependencies = /* @__PURE__ */ new Map();
+  if (!await exists("package.json")) return dependencies;
+  const content = await fs9.readFile("package.json");
+  const parsed = JSON.parse(content.toString());
+  if ("dependencies" in parsed && typeof parsed.dependencies === "object") {
+    const records = parsed.dependencies;
+    Object.entries(records).forEach(([k, v]) => {
+      dependencies.set(k, v);
+    });
+  }
+  if ("devDependencies" in parsed && typeof parsed.devDependencies === "object") {
+    const records = parsed.devDependencies;
+    Object.entries(records).forEach(([k, v]) => {
+      dependencies.set(k, v);
+    });
+  }
+  return dependencies;
+}
+
+// src/utils/add/install-deps.ts
+async function installDeps(results) {
+  const installed = await getDeps();
+  const deps = {};
+  const devDeps = {};
+  for (const result of results) {
+    Object.assign(deps, result.dependencies);
+    Object.assign(devDeps, result.devDependencies);
+  }
+  const items = Object.entries(deps).filter(([k]) => !installed.has(k)).map(([k, v]) => v.length === 0 ? k : `${k}@${v}`);
+  const devItems = Object.entries(devDeps).filter(([k]) => !installed.has(k)).map(([k, v]) => v.length === 0 ? k : `${k}@${v}`);
+  if (items.length > 0 || devItems.length > 0) {
+    const manager = await getPackageManager();
+    const value = await confirm3({
+      message: `Do you want to install with ${manager}?
+${[...items, ...devItems].map((v) => `- ${v}`).join("\n")}`
+    });
+    if (isCancel3(value)) {
+      return;
+    }
+    if (value) {
+      const spin = spinner2();
+      spin.start("Installing dependencies...");
+      if (items.length > 0) await x3(manager, ["install", ...items]);
+      if (devItems.length > 0) await x3(manager, ["install", ...devItems, "-D"]);
+      spin.stop("Dependencies installed.");
+    }
+  }
+}
+
+// src/commands/add.ts
+async function add(input, resolver, config) {
+  let target = input;
+  if (input.length === 0) {
+    const spin = spinner3();
+    spin.start("fetching registry");
+    const registry = await resolver("_registry.json");
+    spin.stop(picocolors3.bold(picocolors3.greenBright("registry fetched")));
+    if (!registry) {
+      log5.error(`Failed to fetch '_registry.json' file from registry`);
+      throw new Error(`Failed to fetch registry`);
+    }
+    const value = await multiselect({
+      message: "Select components to install",
+      options: registry.map((item) => ({
+        label: item.name,
+        value: item.name,
+        hint: item.description
+      }))
+    });
+    if (isCancel4(value)) {
+      outro2("Ended");
+      return;
+    }
+    target = value;
+  }
+  await install(target, resolver, config);
+}
+async function install(target, resolver, config) {
+  const outputs = [];
+  for (const name of target) {
+    intro2(
+      picocolors3.bold(
+        picocolors3.inverse(picocolors3.cyanBright(`Add Component: ${name}`))
+      )
+    );
+    const output = await installComponent(name, resolver, config);
+    if (!output) {
+      log5.error(`Failed to install ${name}: not found`);
+      continue;
+    }
+    outro2(picocolors3.bold(picocolors3.greenBright(`${name} installed`)));
+    outputs.push(output);
+  }
+  intro2(picocolors3.bold("New Dependencies"));
+  await installDeps(outputs);
+  outro2(picocolors3.bold(picocolors3.greenBright("Successful")));
+}
+
+// src/commands/customise.ts
 async function customise(resolver, config) {
-  intro3(picocolors5.bgBlack(picocolors5.whiteBright("Customise Fumadocs UI")));
+  intro3(picocolors4.bgBlack(picocolors4.whiteBright("Customise Fumadocs UI")));
   const result = await group(
     {
       target: () => select({
@@ -977,6 +964,11 @@ async function customise(resolver, config) {
             label: "Docs Layout",
             value: "docs",
             hint: "main UI of your docs"
+          },
+          {
+            label: "Home Layout",
+            value: "home",
+            hint: "the navbar for your other pages"
           }
         ]
       }),
@@ -1006,7 +998,7 @@ async function customise(resolver, config) {
       page: async (v) => {
         if (v.results.target !== "docs" || v.results.mode === "minimal")
           return false;
-        return confirm3({
+        return confirm4({
           message: "Do you want to customise the page component too?"
         });
       }
@@ -1018,39 +1010,62 @@ async function customise(resolver, config) {
       }
     }
   );
-  if (result.target === "docs" && result.mode) {
-    if (result.page) await add("layouts/page", resolver, config);
+  if (result.target === "docs") {
+    const targets = [];
+    let pageAdded = false;
     if (result.mode === "minimal") {
-      await add("layouts/docs-min", resolver, config);
+      targets.push("layouts/docs-min");
+      pageAdded = true;
     } else {
-      await add(
-        result.mode === "full-default" ? "layouts/docs" : "layouts/notebook",
-        resolver,
-        config
+      if (result.page) {
+        targets.push("layouts/page");
+        pageAdded = true;
+      }
+      targets.push(
+        result.mode === "full-default" ? "layouts/docs" : "layouts/notebook"
       );
     }
-    log5.info(
+    await install(targets, resolver, config);
+    intro3(picocolors4.bold("What is Next?"));
+    log6.info(
       [
-        picocolors5.bold("What is Next?"),
         "You can check the installed components in `components/layouts`.",
-        picocolors5.dim("---"),
+        picocolors4.dim("---"),
         "Open your `layout.tsx` files, replace the imports of components:",
-        picocolors5.greenBright(
+        picocolors4.greenBright(
           "`fumadocs-ui/layouts/docs` -> `@/components/layouts/docs`"
         ),
-        result.page || result.mode === "minimal" ? picocolors5.greenBright(
+        pageAdded ? picocolors4.greenBright(
           "`fumadocs-ui/page` -> `@/components/layouts/page`"
         ) : ""
       ].join("\n")
     );
   }
+  if (result.target === "home") {
+    await install(["layouts/home"], resolver, config);
+    intro3(picocolors4.bold("What is Next?"));
+    log6.info(
+      [
+        "You can check the installed components in `components/layouts`.",
+        picocolors4.dim("---"),
+        "Open your `layout.tsx` files, replace the imports of components:",
+        picocolors4.greenBright(
+          "`fumadocs-ui/layouts/home` -> `@/components/layouts/home`"
+        )
+      ].join("\n")
+    );
+  }
+  outro3(picocolors4.bold("Have fun!"));
 }
 
 // src/index.ts
 var program = new Command().option("--config <string>");
 program.name("fumadocs").description("CLI to setup Fumadocs, init a config ").version(package_default.version).action(async () => {
-  await initConfig();
-  console.log(picocolors6.green("Initialized a `./cli.json` config file."));
+  if (await initConfig()) {
+    console.log(picocolors5.green("Initialized a `./cli.json` config file."));
+  } else {
+    console.log(picocolors5.redBright("A config file already exists."));
+  }
 });
 program.command("customise").alias("customize").description("simple way to customise layouts with Fumadocs UI").option("--dir <string>", "the root url or directory to resolve registry").action(async (options) => {
   const resolver = getResolverFromDir(options.dir);
@@ -1071,48 +1086,20 @@ program.command("init").description("init a new plugin to your docs").argument("
       value: c
     }))
   });
-  if (isCancel3(value)) {
-    outro2("Ended");
+  if (isCancel5(value)) {
+    outro4("Ended");
     return;
   }
   await init(plugins[value], loadedConfig);
 });
 var dirShortcuts = {
-  ":dev": "https://fumadocs-dev.vercel.app/registry"
+  ":dev": "https://preview.fumadocs.dev/registry",
+  ":localhost": "http://localhost:3000/registry"
 };
 program.command("add").description("add a new component to your docs").argument("[components...]", "components to download").option("--dir <string>", "the root url or directory to resolve registry").action(
   async (input, options) => {
     const resolver = getResolverFromDir(options.dir);
-    let target = input;
-    if (input.length === 0) {
-      const spin = spinner3();
-      spin.start("fetching registry");
-      const registry = await resolver("_registry.json");
-      spin.stop(picocolors6.bold(picocolors6.greenBright("registry fetched")));
-      if (!registry) {
-        log6.error(
-          `Failed to fetch '_registry.json' file from ${options.dir ?? "registry"}`
-        );
-        throw new Error(`Failed to fetch registry`);
-      }
-      const value = await multiselect({
-        message: "Select components to install",
-        options: registry.map((item) => ({
-          label: item.name,
-          value: item.name,
-          hint: item.description
-        }))
-      });
-      if (isCancel3(value)) {
-        outro2("Ended");
-        return;
-      }
-      target = value;
-    }
-    const loadedConfig = await loadConfig(options.config);
-    for (const name of target) {
-      await add(name, resolver, loadedConfig);
-    }
+    await add(input, resolver, await loadConfig(options.config));
   }
 );
 program.command("tree").argument(
@@ -1141,7 +1128,7 @@ program.command("tree").argument(
     }
   }
 );
-function getResolverFromDir(dir = "https://fumadocs.vercel.app/registry") {
+function getResolverFromDir(dir = "https://fumadocs.dev/registry") {
   if (dir in dirShortcuts) dir = dirShortcuts[dir];
   return dir.startsWith("http://") || dir.startsWith("https://") ? remoteResolver(dir) : localResolver(dir);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fumadocs/cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "The CLI tool for Fumadocs",
   "keywords": [
     "NextJs",
@@ -26,19 +26,17 @@
     "dist/*"
   ],
   "dependencies": {
-    "@clack/prompts": "^0.10.0",
-    "commander": "^13.1.0",
-    "execa": "^9.5.2",
-    "package-manager-detector": "^1.1.0",
+    "@clack/prompts": "^0.10.1",
+    "commander": "^14.0.0",
+    "package-manager-detector": "^1.3.0",
     "picocolors": "^1.1.1",
-    "ts-morph": "^25.0.1"
+    "tinyexec": "^1.0.1",
+    "ts-morph": "^26.0.0"
   },
   "devDependencies": {
-    "@types/cross-spawn": "^6.0.6",
-    "@types/node": "22.13.16",
-    "@types/react": "^19.0.12",
-    "fast-glob": "^3.3.3",
-    "tsx": "^4.19.3",
+    "@types/node": "22.15.19",
+    "@types/react": "^19.1.4",
+    "tsx": "^4.19.4",
     "eslint-config-custom": "0.0.0",
     "tsconfig": "0.0.0"
   },