centoui-cli 0.2.0 → 0.2.2

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Favour Emeka
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Favour Emeka
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.mjs

@@ -1,13 +1,14 @@
 #!/usr/bin/env node
 import { defineCommand, runMain } from "citty";
 import { cancel, confirm, group, intro, isCancel, log, note, outro, tasks, text } from "@clack/prompts";
-import { join } from "pathe";
+import { dirname, join } from "pathe";
 import fsExtra from "fs-extra";
 import { addDependency } from "nypm";
+import { pathToFileURL } from "node:url";
 //#endregion
 //#region src/constants.ts
 /** CentoUI current package version */
-const VERSION = "0.2.0";
+const VERSION = "0.2.2";
 /** CentoUI config file name */
 const CONFIG_FILE_NAME = "centoui.config.ts";
 /** CentoUI registry file name */
@@ -64,6 +65,36 @@ function validatePath(path) {
 //#endregion
 //#region src/utils/file-system-utils.ts
 /**
+* Resolve the destination path for a component file inside the user's project.
+* Strips the leading `src/components/` registry prefix.
+*
+* e.g. with `componentsDir = './components/ui'`:
+*   src/components/button/button.vue → ./components/ui/button/button.vue
+*
+* @param path - The path to the component file in the registry.
+* @param config - The CentoUI configuration.
+* @param cwd - The current working directory.
+* @returns The destination path for the component file.
+*/
+function resolveComponentsDestinationPath(path, config, cwd) {
+	const normalizedPath = path.replace(/^components\//, "");
+	return join(cwd, config.componentsDir, normalizedPath);
+}
+/**
+* Write content to a destination path, creating parent directories as needed.
+*
+* @param path - The path to write the file to.
+* @param content - The content to write to the file.
+*/
+async function writeFile(path, content) {
+	try {
+		await fsExtra.mkdir(dirname(path), { recursive: true });
+		await fsExtra.writeFile(path, content, "utf8");
+	} catch (error) {
+		throw new Error(`Failed to write file: ${path}: ${error}`);
+	}
+}
+/**
 * Ask the user whether to overwrite a path that already exists.
 * Returns `true` immediately (no prompt) if the file does not exist yet.
 *
@@ -82,6 +113,22 @@ async function promptOverwrite(label, path) {
 //#endregion
 //#region src/utils/config-utils.ts
 /**
+* Loads the user's CentoUI configuration.
+*
+* @param cwd - The current working directory.
+* @returns The user's CentoUI configuration.
+* @throws If the config file is not found or cannot be loaded.
+*/
+async function loadUserConfig(cwd) {
+	try {
+		const configFilePath = join(cwd, CONFIG_FILE_NAME);
+		if (!await fsExtra.pathExists(configFilePath)) throw `No ${CONFIG_FILE_NAME} found. Run \`centoui init\` first.`;
+		return (await import(pathToFileURL(configFilePath).href)).default;
+	} catch (error) {
+		throw new Error(`Failed to load user config: ${error}`);
+	}
+}
+/**
 * Generates the default user-defined CentoUI config file template.
 * @param themeFilePath - The relative path to the user's theme CSS file.
 * @param componentsDir - The relative path to the user's components directory.
@@ -121,6 +168,36 @@ async function fetchRegistry() {
 	return registry;
 }
 /**
+* Recursively resolves a component and all its transitive dependencies.
+*
+* @param name - Root component name to resolve
+* @param registry - The pre-fetched registry index
+* @param seen - Internal set used to prevent infinite loops on circular deps
+* @returns Map of component name → registry entry for the full dependency tree
+*/
+function resolveComponentTree(name, registry, seen = /* @__PURE__ */ new Set()) {
+	const result = /* @__PURE__ */ new Map();
+	if (seen.has(name)) return result;
+	seen.add(name);
+	const entry = registry.components.find((component) => component.name === name);
+	if (!entry) throw new Error(`Component "${name}" not found in registry.`);
+	result.set(name, entry);
+	for (const dependency of entry.componentDeps) for (const [dependencyName, dependencyEntry] of resolveComponentTree(dependency, registry, seen)) result.set(dependencyName, dependencyEntry);
+	return result;
+}
+/**
+* Fetches the raw source code of a component or utility file from the registry.
+*
+* @param path - Path as listed in the component registry (e.g. 'components/button/button.vue')
+* @returns The raw source code of the file
+*/
+async function fetchComponentFile(path) {
+	const requestUrl = `${BASE_URL}/${path}`;
+	const response = await fetch(requestUrl, { headers: FETCH_HEADERS });
+	if (!response.ok) throw new Error(`${response.status}: ${response.statusText}`);
+	return response.text();
+}
+/**
 * Fetches the theme file from the registry.
 *
 * @returns The raw source code of the theme file
@@ -220,13 +297,99 @@ function init() {
 	});
 }
 //#endregion
+//#region src/utils/components-utils.ts
+/**
+* Resolves the absolute path to a specific component directory.
+*
+* @param name - The name of the component (kebab-case)
+* @param config - CentoUI configuration
+* @param cwd - Current working directory
+* @returns The absolute path to the component directory
+*/
+function getComponentPath(name, config, cwd) {
+	return join(cwd, config.componentsDir, name);
+}
+//#endregion
+//#region src/commands/add.ts
+/**
+* Command: add
+*
+* Installs one or more components (and their transitive dependencies) from
+* the registry into the user's project.
+*/
+function add() {
+	return defineCommand({
+		meta: {
+			name: "add",
+			description: "Add one or more components to your project"
+		},
+		args: {},
+		async run({ args }) {
+			try {
+				const cwd = process.cwd();
+				const componentNames = args._;
+				intro("CentoUI — Add components");
+				if (componentNames.length === 0) {
+					log.error("No components specified. Usage: centoui add <component> [component...]");
+					process.exit(1);
+				}
+				const config = await loadUserConfig(cwd);
+				const registry = await fetchRegistry();
+				const allComponents = /* @__PURE__ */ new Map();
+				for (const name of componentNames) try {
+					const tree = resolveComponentTree(name, registry);
+					for (const [depName, depEntry] of tree) allComponents.set(depName, depEntry);
+				} catch (error) {
+					log.error(`Failed to resolve "${name}": ${error}`);
+					process.exit(1);
+				}
+				const installDecisions = /* @__PURE__ */ new Map();
+				for (const [name] of allComponents) {
+					const shouldWrite = await promptOverwrite(name, getComponentPath(name, config, cwd));
+					installDecisions.set(name, shouldWrite);
+				}
+				const allPackageDeps = {};
+				for (const [name, entry] of allComponents) if (installDecisions.get(name)) Object.assign(allPackageDeps, entry.packageDeps);
+				const componentsToInstall = Array.from(allComponents.entries()).filter(([name]) => installDecisions.get(name));
+				await tasks([...componentsToInstall.map(([name, entry]) => ({
+					title: `Installing ${name}`,
+					task: async () => {
+						for (const path of entry.files) {
+							const content = await fetchComponentFile(path);
+							await writeFile(resolveComponentsDestinationPath(path, config, cwd), content);
+						}
+						return `${name} installed (${entry.files.length} file${entry.files.length !== 1 ? "s" : ""})`;
+					}
+				})), {
+					title: "Installing packages",
+					task: async (message) => installPackages(allPackageDeps, cwd, message)
+				}]);
+				const skipped = Array.from(installDecisions.entries()).filter(([, shouldWrite]) => !shouldWrite).map(([name]) => name);
+				note([
+					`Installed  > ${componentsToInstall.map(([name]) => name).join(", ") || "none"}`,
+					skipped.length > 0 ? `Skipped    > ${skipped.join(", ")}` : "",
+					"",
+					"Import components from your components directory to use them"
+				].filter(Boolean).join("\n"), "Components added");
+				outro("All set!");
+			} catch (error) {
+				log.error(`Failed to add component(s): ${error}`);
+				process.exit(1);
+			}
+		}
+	});
+}
+//#endregion
 //#region src/index.ts
 runMain(defineCommand({
 	meta: {
 		name: "centoui",
 		version: VERSION
 	},
-	subCommands: { init }
+	subCommands: {
+		init,
+		add
+	}
 }));
 //#endregion
 export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "centoui-cli",
   "type": "module",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "private": false,
   "description": "Official CLI for CentoUI.",
   "author": "Favour Emeka <favorodera@gmail.com>",