@fumadocs/cli 1.3.3 → 1.3.5

package/dist/config.d.ts

@@ -1,2 +1,53 @@
-import { a as createOrLoadConfig, i as createConfigSchema, n as Framework, o as getDefaultConfig, r as LoadedConfig, s as initConfig, t as ConfigInput } from "./config-Bx-m6awG.js";
-export { ConfigInput, Framework, LoadedConfig, createConfigSchema, createOrLoadConfig, getDefaultConfig, initConfig };
+import { z } from "zod";
+
+//#region src/config.d.ts
+declare const frameworks: readonly ["next", "waku", "react-router", "tanstack-start"];
+type Framework = (typeof frameworks)[number];
+declare function createConfigSchema(cwd?: any): z.ZodObject<{
+  $schema: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+  aliases: z.ZodDefault<z.ZodObject<{
+    uiDir: z.ZodDefault<z.ZodString>;
+    componentsDir: z.ZodDefault<z.ZodString>;
+    layoutDir: z.ZodDefault<z.ZodString>;
+    cssDir: z.ZodDefault<z.ZodString>;
+    libDir: z.ZodDefault<z.ZodString>;
+  }, z.core.$strip>>;
+  baseDir: z.ZodDefault<z.ZodString>;
+  uiLibrary: z.ZodDefault<z.ZodEnum<{
+    "radix-ui": "radix-ui";
+    "base-ui": "base-ui";
+  }>>;
+  framework: z.ZodDefault<z.ZodLiteral<"next" | "waku" | "react-router" | "tanstack-start">>;
+  commands: z.ZodDefault<z.ZodObject<{
+    format: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type ConfigSchema = ReturnType<typeof createConfigSchema>;
+type ConfigInput = z.input<ConfigSchema>;
+type LoadedConfig = z.output<ConfigSchema>;
+declare function createOrLoadConfig(file?: string): Promise<LoadedConfig>;
+/**
+ * Write new config, skip if a config already exists
+ *
+ * @returns the created config, `undefined` if not created
+ */
+declare function initConfig(file?: string): Promise<LoadedConfig | undefined>;
+declare function getDefaultConfig(cwd?: string): Promise<{
+  aliases: {
+    uiDir: string;
+    componentsDir: string;
+    layoutDir: string;
+    cssDir: string;
+    libDir: string;
+  };
+  baseDir: string;
+  uiLibrary: "radix-ui" | "base-ui";
+  framework: "next" | "waku" | "react-router" | "tanstack-start";
+  commands: {
+    format?: string | undefined;
+  };
+  $schema?: string | undefined;
+}>;
+//#endregion
+export { ConfigInput, Framework, LoadedConfig, createConfigSchema, createOrLoadConfig, getDefaultConfig, initConfig };
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","names":[],"sources":["../src/config.ts"],"mappings":";;;cAKM,UAAA;AAAA,KACM,SAAA,WAAoB,UAAA;AAAA,iBAEhB,kBAAA,CAAmB,GAAA,SAAmB,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;KA2DjD,YAAA,GAAe,UAAA,QAAkB,kBAAA;AAAA,KAE1B,WAAA,GAAc,CAAA,CAAE,KAAA,CAAM,YAAA;AAAA,KACtB,YAAA,GAAe,CAAA,CAAE,MAAA,CAAO,YAAA;AAAA,iBAEd,kBAAA,CAAmB,IAAA,YAAsB,OAAA,CAAQ,YAAA;;;;;;iBAejD,UAAA,CAAW,IAAA,YAAsB,OAAA,CAAQ,YAAA;AAAA,iBAezC,gBAAA,CAAiB,GAAA,YAAY,OAAA"}

package/dist/config.js

@@ -1,6 +1,7 @@
 import fs from "node:fs/promises";
 import { z } from "zod";
 import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
 //#region src/config.ts
 const frameworks = [
 	"next",
@@ -8,7 +9,9 @@ const frameworks = [
 	"react-router",
 	"tanstack-start"
 ];
-function createConfigSchema() {
+function createConfigSchema(cwd = process.cwd()) {
+	const srcDir = path.resolve(cwd, "src");
+	const packageJsonPath = path.resolve(cwd, "package.json");
 	const defaultAliases = {
 		uiDir: "./components/ui",
 		componentsDir: "./components",
@@ -25,15 +28,15 @@ function createConfigSchema() {
 			cssDir: z.string().default(defaultAliases.componentsDir),
 			libDir: z.string().default(defaultAliases.libDir)
 		}).default(defaultAliases),
-		baseDir: z.string().default(() => existsSync("./src") ? "src" : ""),
+		baseDir: z.string().default(() => existsSync(srcDir) ? "src" : ""),
 		uiLibrary: z.enum(["radix-ui", "base-ui"]).default("radix-ui"),
 		framework: z.literal(frameworks).default(() => {
-			return detectFrameworkFromPackageJson() ?? "next";
+			return detectFrameworkFromPackageJson(packageJsonPath) ?? "next";
 		}),
 		commands: z.object({ format: z.string().optional() }).default({})
 	});
 }
-function detectFrameworkFromPackageJson(pkgPath = "./package.json") {
+function detectFrameworkFromPackageJson(pkgPath) {
 	try {
 		const pkgRaw = readFileSync(pkgPath, "utf-8");
 		const pkg = JSON.parse(pkgRaw);
@@ -66,8 +69,8 @@ async function initConfig(file = "./cli.json") {
 	await fs.writeFile(file, JSON.stringify(defaultConfig, null, 2));
 	return defaultConfig;
 }
-async function getDefaultConfig() {
-	return createConfigSchema().parse({});
+async function getDefaultConfig(cwd) {
+	return createConfigSchema(cwd).parse({});
 }
 //#endregion
 export { createConfigSchema, createOrLoadConfig, getDefaultConfig, initConfig };

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","names":[],"sources":["../src/config.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport { z } from 'zod';\nimport { existsSync, readFileSync } from 'node:fs';\n\nconst frameworks = ['next', 'waku', 'react-router', 'tanstack-start'] as const;\nexport type Framework = (typeof frameworks)[number];\n\nexport function createConfigSchema() {\n  const defaultAliases = {\n    uiDir: './components/ui',\n    componentsDir: './components',\n    layoutDir: './layouts',\n    cssDir: './styles',\n    libDir: './lib',\n  };\n\n  return z.object({\n    $schema: z.string().default('node_modules/@fumadocs/cli/dist/schema.json').optional(),\n    aliases: z\n      .object({\n        uiDir: z.string().default(defaultAliases.uiDir),\n        componentsDir: z.string().default(defaultAliases.uiDir),\n        layoutDir: z.string().default(defaultAliases.layoutDir),\n        cssDir: z.string().default(defaultAliases.componentsDir),\n        libDir: z.string().default(defaultAliases.libDir),\n      })\n      .default(defaultAliases),\n\n    baseDir: z.string().default(() => (existsSync('./src') ? 'src' : '')),\n    uiLibrary: z.enum(['radix-ui', 'base-ui']).default('radix-ui'),\n    framework: z.literal(frameworks).default(() => {\n      return detectFrameworkFromPackageJson() ?? 'next';\n    }),\n\n    commands: z\n      .object({\n        /**\n         * command to format output code automatically\n         */\n        format: z.string().optional(),\n      })\n      .default({}),\n  });\n}\n\nfunction detectFrameworkFromPackageJson(pkgPath = './package.json'): Framework | undefined {\n  try {\n    const pkgRaw = readFileSync(pkgPath, 'utf-8');\n    const pkg = JSON.parse(pkgRaw);\n\n    const deps = {\n      ...pkg.dependencies,\n      ...pkg.devDependencies,\n    };\n\n    if (deps['next']) return 'next';\n    if (deps['waku']) return 'waku';\n    if (deps['react-router'] || deps['react-router-dom']) return 'react-router';\n    if (deps['@tanstack/react-start']) return 'tanstack-start';\n  } catch {\n    return;\n  }\n}\n\ntype ConfigSchema = ReturnType<typeof createConfigSchema>;\n\nexport type ConfigInput = z.input<ConfigSchema>;\nexport type LoadedConfig = z.output<ConfigSchema>;\n\nexport async function createOrLoadConfig(file = './cli.json'): Promise<LoadedConfig> {\n  const inited = await initConfig(file);\n  if (inited) return inited;\n\n  const content = (await fs.readFile(file)).toString();\n  const configSchema = createConfigSchema();\n\n  return configSchema.parse(JSON.parse(content));\n}\n\n/**\n * Write new config, skip if a config already exists\n *\n * @returns the created config, `undefined` if not created\n */\nexport async function initConfig(file = './cli.json'): Promise<LoadedConfig | undefined> {\n  if (\n    await fs\n      .stat(file)\n      .then(() => true)\n      .catch(() => false)\n  ) {\n    return;\n  }\n\n  const defaultConfig = await getDefaultConfig();\n  await fs.writeFile(file, JSON.stringify(defaultConfig, null, 2));\n  return defaultConfig;\n}\n\nexport async function getDefaultConfig() {\n  return createConfigSchema().parse({} satisfies ConfigInput);\n}\n"],"mappings":";;;;AAIA,MAAM,aAAa;CAAC;CAAQ;CAAQ;CAAgB;CAAiB;AAGrE,SAAgB,qBAAqB;CACnC,MAAM,iBAAiB;EACrB,OAAO;EACP,eAAe;EACf,WAAW;EACX,QAAQ;EACR,QAAQ;EACT;AAED,QAAO,EAAE,OAAO;EACd,SAAS,EAAE,QAAQ,CAAC,QAAQ,8CAA8C,CAAC,UAAU;EACrF,SAAS,EACN,OAAO;GACN,OAAO,EAAE,QAAQ,CAAC,QAAQ,eAAe,MAAM;GAC/C,eAAe,EAAE,QAAQ,CAAC,QAAQ,eAAe,MAAM;GACvD,WAAW,EAAE,QAAQ,CAAC,QAAQ,eAAe,UAAU;GACvD,QAAQ,EAAE,QAAQ,CAAC,QAAQ,eAAe,cAAc;GACxD,QAAQ,EAAE,QAAQ,CAAC,QAAQ,eAAe,OAAO;GAClD,CAAC,CACD,QAAQ,eAAe;EAE1B,SAAS,EAAE,QAAQ,CAAC,cAAe,WAAW,QAAQ,GAAG,QAAQ,GAAI;EACrE,WAAW,EAAE,KAAK,CAAC,YAAY,UAAU,CAAC,CAAC,QAAQ,WAAW;EAC9D,WAAW,EAAE,QAAQ,WAAW,CAAC,cAAc;AAC7C,UAAO,gCAAgC,IAAI;IAC3C;EAEF,UAAU,EACP,OAAO,EAIN,QAAQ,EAAE,QAAQ,CAAC,UAAU,EAC9B,CAAC,CACD,QAAQ,EAAE,CAAC;EACf,CAAC;;AAGJ,SAAS,+BAA+B,UAAU,kBAAyC;AACzF,KAAI;EACF,MAAM,SAAS,aAAa,SAAS,QAAQ;EAC7C,MAAM,MAAM,KAAK,MAAM,OAAO;EAE9B,MAAM,OAAO;GACX,GAAG,IAAI;GACP,GAAG,IAAI;GACR;AAED,MAAI,KAAK,QAAS,QAAO;AACzB,MAAI,KAAK,QAAS,QAAO;AACzB,MAAI,KAAK,mBAAmB,KAAK,oBAAqB,QAAO;AAC7D,MAAI,KAAK,yBAA0B,QAAO;SACpC;AACN;;;AASJ,eAAsB,mBAAmB,OAAO,cAAqC;CACnF,MAAM,SAAS,MAAM,WAAW,KAAK;AACrC,KAAI,OAAQ,QAAO;CAEnB,MAAM,WAAW,MAAM,GAAG,SAAS,KAAK,EAAE,UAAU;AAGpD,QAFqB,oBAAoB,CAErB,MAAM,KAAK,MAAM,QAAQ,CAAC;;;;;;;AAQhD,eAAsB,WAAW,OAAO,cAAiD;AACvF,KACE,MAAM,GACH,KAAK,KAAK,CACV,WAAW,KAAK,CAChB,YAAY,MAAM,CAErB;CAGF,MAAM,gBAAgB,MAAM,kBAAkB;AAC9C,OAAM,GAAG,UAAU,MAAM,KAAK,UAAU,eAAe,MAAM,EAAE,CAAC;AAChE,QAAO;;AAGT,eAAsB,mBAAmB;AACvC,QAAO,oBAAoB,CAAC,MAAM,EAAE,CAAuB"}
+{"version":3,"file":"config.js","names":[],"sources":["../src/config.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport { z } from 'zod';\nimport { existsSync, readFileSync } from 'node:fs';\nimport path from 'node:path';\n\nconst frameworks = ['next', 'waku', 'react-router', 'tanstack-start'] as const;\nexport type Framework = (typeof frameworks)[number];\n\nexport function createConfigSchema(cwd = process.cwd()) {\n  const srcDir = path.resolve(cwd, 'src');\n  const packageJsonPath = path.resolve(cwd, 'package.json');\n  const defaultAliases = {\n    uiDir: './components/ui',\n    componentsDir: './components',\n    layoutDir: './layouts',\n    cssDir: './styles',\n    libDir: './lib',\n  };\n\n  return z.object({\n    $schema: z.string().default('node_modules/@fumadocs/cli/dist/schema.json').optional(),\n    aliases: z\n      .object({\n        uiDir: z.string().default(defaultAliases.uiDir),\n        componentsDir: z.string().default(defaultAliases.uiDir),\n        layoutDir: z.string().default(defaultAliases.layoutDir),\n        cssDir: z.string().default(defaultAliases.componentsDir),\n        libDir: z.string().default(defaultAliases.libDir),\n      })\n      .default(defaultAliases),\n\n    baseDir: z.string().default(() => (existsSync(srcDir) ? 'src' : '')),\n    uiLibrary: z.enum(['radix-ui', 'base-ui']).default('radix-ui'),\n    framework: z.literal(frameworks).default(() => {\n      return detectFrameworkFromPackageJson(packageJsonPath) ?? 'next';\n    }),\n\n    commands: z\n      .object({\n        /**\n         * command to format output code automatically\n         */\n        format: z.string().optional(),\n      })\n      .default({}),\n  });\n}\n\nfunction detectFrameworkFromPackageJson(pkgPath: string): Framework | undefined {\n  try {\n    const pkgRaw = readFileSync(pkgPath, 'utf-8');\n    const pkg = JSON.parse(pkgRaw);\n\n    const deps = {\n      ...pkg.dependencies,\n      ...pkg.devDependencies,\n    };\n\n    if (deps['next']) return 'next';\n    if (deps['waku']) return 'waku';\n    if (deps['react-router'] || deps['react-router-dom']) return 'react-router';\n    if (deps['@tanstack/react-start']) return 'tanstack-start';\n  } catch {\n    return;\n  }\n}\n\ntype ConfigSchema = ReturnType<typeof createConfigSchema>;\n\nexport type ConfigInput = z.input<ConfigSchema>;\nexport type LoadedConfig = z.output<ConfigSchema>;\n\nexport async function createOrLoadConfig(file = './cli.json'): Promise<LoadedConfig> {\n  const inited = await initConfig(file);\n  if (inited) return inited;\n\n  const content = (await fs.readFile(file)).toString();\n  const configSchema = createConfigSchema();\n\n  return configSchema.parse(JSON.parse(content));\n}\n\n/**\n * Write new config, skip if a config already exists\n *\n * @returns the created config, `undefined` if not created\n */\nexport async function initConfig(file = './cli.json'): Promise<LoadedConfig | undefined> {\n  if (\n    await fs\n      .stat(file)\n      .then(() => true)\n      .catch(() => false)\n  ) {\n    return;\n  }\n\n  const defaultConfig = await getDefaultConfig();\n  await fs.writeFile(file, JSON.stringify(defaultConfig, null, 2));\n  return defaultConfig;\n}\n\nexport async function getDefaultConfig(cwd?: string) {\n  return createConfigSchema(cwd).parse({} satisfies ConfigInput);\n}\n"],"mappings":";;;;;AAKA,MAAM,aAAa;CAAC;CAAQ;CAAQ;CAAgB;CAAiB;AAGrE,SAAgB,mBAAmB,MAAM,QAAQ,KAAK,EAAE;CACtD,MAAM,SAAS,KAAK,QAAQ,KAAK,MAAM;CACvC,MAAM,kBAAkB,KAAK,QAAQ,KAAK,eAAe;CACzD,MAAM,iBAAiB;EACrB,OAAO;EACP,eAAe;EACf,WAAW;EACX,QAAQ;EACR,QAAQ;EACT;AAED,QAAO,EAAE,OAAO;EACd,SAAS,EAAE,QAAQ,CAAC,QAAQ,8CAA8C,CAAC,UAAU;EACrF,SAAS,EACN,OAAO;GACN,OAAO,EAAE,QAAQ,CAAC,QAAQ,eAAe,MAAM;GAC/C,eAAe,EAAE,QAAQ,CAAC,QAAQ,eAAe,MAAM;GACvD,WAAW,EAAE,QAAQ,CAAC,QAAQ,eAAe,UAAU;GACvD,QAAQ,EAAE,QAAQ,CAAC,QAAQ,eAAe,cAAc;GACxD,QAAQ,EAAE,QAAQ,CAAC,QAAQ,eAAe,OAAO;GAClD,CAAC,CACD,QAAQ,eAAe;EAE1B,SAAS,EAAE,QAAQ,CAAC,cAAe,WAAW,OAAO,GAAG,QAAQ,GAAI;EACpE,WAAW,EAAE,KAAK,CAAC,YAAY,UAAU,CAAC,CAAC,QAAQ,WAAW;EAC9D,WAAW,EAAE,QAAQ,WAAW,CAAC,cAAc;AAC7C,UAAO,+BAA+B,gBAAgB,IAAI;IAC1D;EAEF,UAAU,EACP,OAAO,EAIN,QAAQ,EAAE,QAAQ,CAAC,UAAU,EAC9B,CAAC,CACD,QAAQ,EAAE,CAAC;EACf,CAAC;;AAGJ,SAAS,+BAA+B,SAAwC;AAC9E,KAAI;EACF,MAAM,SAAS,aAAa,SAAS,QAAQ;EAC7C,MAAM,MAAM,KAAK,MAAM,OAAO;EAE9B,MAAM,OAAO;GACX,GAAG,IAAI;GACP,GAAG,IAAI;GACR;AAED,MAAI,KAAK,QAAS,QAAO;AACzB,MAAI,KAAK,QAAS,QAAO;AACzB,MAAI,KAAK,mBAAmB,KAAK,oBAAqB,QAAO;AAC7D,MAAI,KAAK,yBAA0B,QAAO;SACpC;AACN;;;AASJ,eAAsB,mBAAmB,OAAO,cAAqC;CACnF,MAAM,SAAS,MAAM,WAAW,KAAK;AACrC,KAAI,OAAQ,QAAO;CAEnB,MAAM,WAAW,MAAM,GAAG,SAAS,KAAK,EAAE,UAAU;AAGpD,QAFqB,oBAAoB,CAErB,MAAM,KAAK,MAAM,QAAQ,CAAC;;;;;;;AAQhD,eAAsB,WAAW,OAAO,cAAiD;AACvF,KACE,MAAM,GACH,KAAK,KAAK,CACV,WAAW,KAAK,CAChB,YAAY,MAAM,CAErB;CAGF,MAAM,gBAAgB,MAAM,kBAAkB;AAC9C,OAAM,GAAG,UAAU,MAAM,KAAK,UAAU,eAAe,MAAM,EAAE,CAAC;AAChE,QAAO;;AAGT,eAAsB,iBAAiB,KAAc;AACnD,QAAO,mBAAmB,IAAI,CAAC,MAAM,EAAE,CAAuB"}

package/dist/index.js

@@ -1,17 +1,15 @@
 #!/usr/bin/env node
 import { createOrLoadConfig, initConfig } from "./config.js";
-import { n as LocalRegistryClient, t as HttpRegistryClient } from "./client-C2A4Jf2w.js";
-import { t as ComponentInstaller } from "./installer-BWoLnsXE.js";
-import { t as exists } from "./fs-C3j4H046.js";
+import { t as FumadocsComponentInstaller } from "./installer-zD4jTQWp.js";
 import fs from "node:fs/promises";
 import path from "node:path";
 import { Command } from "commander";
 import picocolors from "picocolors";
 import { x } from "tinyexec";
-import { autocompleteMultiselect, box, cancel, confirm, group, intro, isCancel, log, outro, select, spinner } from "@clack/prompts";
-import { detect } from "package-manager-detector";
+import { autocompleteMultiselect, cancel, group, intro, isCancel, log, outro, select, spinner } from "@clack/prompts";
 import { exec } from "node:child_process";
 import { promisify } from "node:util";
+import { HttpRegistryConnector, LocalRegistryConnector } from "fuma-cli/registry/connector";
 //#region src/commands/file-tree.ts
 const scanned = [
 	"file",
@@ -63,7 +61,7 @@ async function runTree(args) {
 }
 //#endregion
 //#region package.json
-var version = "1.3.3";
+var version = "1.3.5";
 //#endregion
 //#region src/commands/shared.ts
 const UIRegistries = {
@@ -71,146 +69,13 @@ const UIRegistries = {
 	"radix-ui": "fumadocs/radix-ui"
 };
 //#endregion
-//#region src/registry/plugins/preserve.ts
-/**
-* keep references to `fumadocs-ui/layouts/*` components as original, unless the user is installing them directly.
-*/
-function pluginPreserveLayouts() {
-	const layoutNames = [
-		"layouts/home",
-		"layouts/flux",
-		"layouts/notebook",
-		"layouts/docs",
-		"layouts/shared"
-	];
-	const layoutComps = {
-		"@/<dir>/home/index.tsx": "layouts/home",
-		"@/<dir>/shared/index.tsx": "layouts/shared",
-		"@/<dir>/shared/client.tsx": "layouts/shared",
-		"@/<dir>/notebook/index.tsx": "layouts/notebook",
-		"@/<dir>/notebook/client.tsx": "layouts/notebook",
-		"@/<dir>/notebook/page/index.tsx": "layouts/notebook/page",
-		"@/<dir>/notebook/page/client.tsx": "layouts/notebook/page",
-		"@/<dir>/docs/index.tsx": "layouts/docs",
-		"@/<dir>/docs/client.tsx": "layouts/docs",
-		"@/<dir>/docs/page/index.tsx": "layouts/docs/page",
-		"@/<dir>/docs/page/client.tsx": "layouts/docs/page",
-		"@/<dir>/flux/index.tsx": "layouts/flux",
-		"@/<dir>/flux/page/index.tsx": "layouts/flux/page",
-		"@/<dir>/flux/page/client.tsx": "layouts/flux/page"
-	};
-	const layoutNameSet = new Set(layoutNames);
-	return {
-		beforeInstall(comp, { stack }) {
-			if (layoutNameSet.has(stack[0].name)) return;
-			return {
-				...comp,
-				$subComponents: comp.$subComponents.filter((child) => !layoutNameSet.has(child.name))
-			};
-		},
-		transformImport(specifier, { stack }) {
-			if (layoutNameSet.has(stack[0].name) || !(specifier in layoutComps)) return specifier;
-			return `fumadocs-ui/${layoutComps[specifier]}`;
-		}
-	};
-}
-//#endregion
-//#region src/commands/add.ts
-async function add(input, client) {
-	const config = client.config;
-	let target;
-	const installer = new ComponentInstaller(client, { plugins: [pluginPreserveLayouts()] });
-	const registry = UIRegistries[config.uiLibrary];
-	if (input.length === 0) {
-		const spin = spinner();
-		spin.start("fetching registry");
-		const info = await client.fetchRegistryInfo();
-		const options = [];
-		for (const item of info.indexes) options.push({
-			label: item.title ?? item.name,
-			value: item.name,
-			hint: item.description
-		});
-		const { indexes } = await client.createLinkedRegistryClient(registry).fetchRegistryInfo();
-		for (const item of indexes) options.push({
-			label: item.title ?? item.name,
-			value: `${registry}/${item.name}`,
-			hint: item.description
-		});
-		spin.stop(picocolors.bold(picocolors.greenBright("registry fetched")));
-		const value = await autocompleteMultiselect({
-			message: "Select components to install",
-			options
-		});
-		if (isCancel(value)) {
-			outro("Ended");
-			return;
-		}
-		target = value;
-	} else target = await Promise.all(input.map(async (item) => await client.hasComponent(item) ? item : `${registry}/${item}`));
-	await install(target, installer);
-}
-async function install(target, installer) {
-	for (const name of target) {
-		const spin = spinner();
-		spin.start(picocolors.bold(picocolors.cyanBright(`Installing ${name}`)));
-		try {
-			await installer.install(name, {
-				onWarn(message) {
-					spin.message(message);
-				},
-				async confirmFileOverride(options) {
-					spin.clear();
-					const value = await confirm({
-						message: `Do you want to override ${options.path}?`,
-						initialValue: false
-					});
-					if (isCancel(value)) {
-						outro("Installation terminated");
-						process.exit(0);
-					}
-					spin.start(picocolors.bold(picocolors.cyanBright(`Installing ${name}`)));
-					return value;
-				},
-				onFileDownloaded(options) {
-					spin.message(options.path);
-				}
-			});
-			spin.stop(picocolors.bold(picocolors.greenBright(`${name} installed`)));
-		} catch (e) {
-			spin.error(e instanceof Error ? e.message : String(e));
-			process.exit(-1);
-		}
-	}
-	const deps = await installer.deps();
-	if (deps.hasRequired()) {
-		log.message();
-		box([...deps.dependencies, ...deps.devDependencies].join("\n"), "New Dependencies");
-		const pm = (await detect())?.name ?? "npm";
-		const value = await confirm({ message: `Do you want to install with ${pm}?` });
-		if (isCancel(value)) {
-			outro("Installation terminated");
-			process.exit(0);
-		}
-		if (value) {
-			const spin = spinner({ errorMessage: "Failed to install dependencies" });
-			spin.start("Installing dependencies");
-			await deps.installRequired(pm);
-			spin.stop("Dependencies installed");
-		} else await deps.writeRequired();
-	}
-	await installer.onEnd();
-	outro(picocolors.bold(picocolors.greenBright("Successful")));
-}
-//#endregion
 //#region src/commands/customise.ts
-async function customise(client) {
+async function customise(config, connector) {
 	intro(picocolors.bgBlack(picocolors.whiteBright("Customise Fumadocs UI")));
-	const config = client.config;
-	const installer = new ComponentInstaller(client, { plugins: [pluginPreserveLayouts()] });
-	const registry = UIRegistries[config.uiLibrary];
-	const info = await client.createLinkedRegistryClient(registry).fetchRegistryInfo();
-	const target = (await group({
+	const installer = new FumadocsComponentInstaller(connector, config);
+	const subRegistry = UIRegistries[config.uiLibrary];
+	const info = await connector.fetchRegistryInfo(subRegistry);
+	const targetInfo = (await group({
 		layout: () => select({
 			message: "What do you want to customise?",
 			options: [
@@ -218,7 +83,10 @@ async function customise(client) {
 					label: "Docs Layout",
 					value: {
 						id: "docs",
-						target: [`${registry}/layouts/docs`],
+						targets: [{
+							subRegistry,
+							name: "layouts/docs"
+						}],
 						print() {
 							printLayout(["fumadocs-ui/layouts/docs", "@/layouts/docs"], ["fumadocs-ui/layouts/docs/page", "@/layouts/docs/page"]);
 						}
@@ -229,7 +97,10 @@ async function customise(client) {
 					label: "Notebook Layout",
 					value: {
 						id: "notebook",
-						target: [`${registry}/layouts/notebook`],
+						targets: [{
+							subRegistry,
+							name: "layouts/notebook"
+						}],
 						print() {
 							printLayout(["fumadocs-ui/layouts/notebook", "@/layouts/notebook"], ["fumadocs-ui/layouts/notebook/page", "@/layouts/notebook/page"]);
 						}
@@ -240,7 +111,10 @@ async function customise(client) {
 					label: "Flux Layout",
 					value: {
 						id: "flux",
-						target: [`${registry}/layouts/flux`],
+						targets: [{
+							subRegistry,
+							name: "layouts/flux"
+						}],
 						print() {
 							printLayout(["fumadocs-ui/layouts/flux", "@/layouts/flux"], ["fumadocs-ui/layouts/flux/page", "@/layouts/flux/page"]);
 						}
@@ -251,7 +125,10 @@ async function customise(client) {
 					label: "Home Layout",
 					value: {
 						id: "home",
-						target: [`${registry}/layouts/home`],
+						targets: [{
+							subRegistry,
+							name: "layouts/home"
+						}],
 						print() {
 							printLayout(["fumadocs-ui/layouts/home", `@/layouts/home`]);
 						}
@@ -276,7 +153,7 @@ async function customise(client) {
 						hint: "for those who want to build their own UI from ground up",
 						value: {
 							id: "docs-min",
-							target: ["layouts/docs-min"],
+							targets: [{ name: "layouts/docs-min" }],
 							print() {
 								printLayout(["fumadocs-ui/layouts/docs", "@/layouts/docs"], ["fumadocs-ui/layouts/docs/page", "@/layouts/docs/page"]);
 							}
@@ -293,7 +170,10 @@ async function customise(client) {
 								hint: "only replace a part of layout's page, useful for adjusting details",
 								value: {
 									id: index.name,
-									target: [`${registry}/${index.name}`],
+									targets: [{
+										subRegistry,
+										name: index.name
+									}],
 									print() {
 										printSlot({
 											at: `@/layouts/${selected.id}/page/slots/${name}`,
@@ -310,7 +190,10 @@ async function customise(client) {
 							hint: "only replace a part of layout, useful for adjusting details",
 							value: {
 								id: index.name,
-								target: [`${registry}/${index.name}`],
+								targets: [{
+									subRegistry,
+									name: index.name
+								}],
 								print() {
 									printSlot({
 										at: `@/layouts/${selected.id}/slots/${name}`,
@@ -329,8 +212,8 @@ async function customise(client) {
 		cancel("Installation Stopped.");
 		process.exit(0);
 	} })).target;
-	await install(target.target, installer);
-	target.print?.();
+	for (const target of targetInfo.targets) await installer.installInteractive(target.name, target.subRegistry);
+	targetInfo.print?.();
 	outro(picocolors.bold("Have fun!"));
 }
 function printLayout(...maps) {
@@ -499,6 +382,52 @@ return (
 	}
 }
 //#endregion
+//#region src/commands/add.ts
+async function add(input, connector, config) {
+	let targets;
+	const installer = new FumadocsComponentInstaller(connector, config);
+	const subRegistry = UIRegistries[config.uiLibrary];
+	if (input.length === 0) {
+		const spin = spinner();
+		spin.start("fetching registry");
+		async function scan(subRegistry) {
+			return (await connector.fetchRegistryInfo(subRegistry)).indexes.map((item) => ({
+				label: item.title ?? item.name,
+				value: {
+					name: item.name,
+					subRegistry
+				},
+				hint: item.description
+			}));
+		}
+		spin.stop(picocolors.bold(picocolors.greenBright("registry fetched")));
+		const value = await autocompleteMultiselect({
+			message: "Select components to install",
+			options: [...await scan(), ...await scan(subRegistry)]
+		});
+		if (isCancel(value)) {
+			outro("Ended");
+			return;
+		}
+		targets = value;
+	} else targets = await Promise.all(input.map(async (item) => await connector.hasComponent(item) ? { name: item } : {
+		subRegistry,
+		name: item
+	}));
+	for (const target of targets) await installer.installInteractive(target.name, target.subRegistry);
+	outro(picocolors.bold(picocolors.greenBright("Successful")));
+}
+//#endregion
+//#region src/utils/fs.ts
+async function exists(pathLike) {
+	try {
+		await fs.access(pathLike);
+		return true;
+	} catch {
+		return false;
+	}
+}
+//#endregion
 //#region src/commands/export-epub.ts
 const execAsync = promisify(exec);
 async function readPackageJson(cwd) {
@@ -692,14 +621,15 @@ program.name("fumadocs").description("CLI to setup Fumadocs, init a config").ver
 	else console.log(picocolors.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) => {
-	await customise(createClientFromDir(options.dir, await createOrLoadConfig(options.config)));
+	await customise(await createOrLoadConfig(options.config), createClientFromDir(options.dir));
 });
 const dirShortcuts = {
 	":preview": "https://preview.fumadocs.dev/registry",
 	":dev": "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) => {
-	await add(input, createClientFromDir(options.dir, await createOrLoadConfig(options.config)));
+	const config = await createOrLoadConfig(options.config);
+	await add(input, createClientFromDir(options.dir), config);
 });
 program.command("export").description("export documentation to various formats").command("epub").description("export documentation to EPUB format (run after production build)").requiredOption("--framework <name>", "React framework: next, tanstack-start, react-router, waku").option("--output <path>", "output file path", "docs.epub").option("--scaffold-only", "only scaffold the EPUB route, do not copy").action(async (options) => {
 	await exportEpub({
@@ -727,9 +657,9 @@ program.command("tree").argument("[json_or_args]", "JSON output of `tree` comman
 		await fs.writeFile(output, out);
 	} else console.log(out);
 });
-function createClientFromDir(dir = "https://fumadocs.dev/registry", config) {
+function createClientFromDir(dir = "https://fumadocs.dev/registry") {
 	if (dir in dirShortcuts) dir = dirShortcuts[dir];
-	return dir.startsWith("http://") || dir.startsWith("https://") ? new HttpRegistryClient(dir, config) : new LocalRegistryClient(dir, config);
+	return dir.startsWith("http://") || dir.startsWith("https://") ? new HttpRegistryConnector(dir) : new LocalRegistryConnector(dir);
 }
 program.parse();
 //#endregion