centoui-cli 0.0.0 → 0.1.1

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/README.md

@@ -4,13 +4,13 @@
 [![npm downloads](https://img.shields.io/npm/dm/centoui-cli.svg?style=flat-square)](https://www.npmjs.com/package/centoui-cli)
 [![license](https://img.shields.io/github/license/favorodera/centoui.svg?style=flat-square)](https://github.com/favorodera/centoui/blob/main/LICENSE)
 
-**CentoUI CLI: Manage your components with ease.**
+**CentoUI CLI: Manage your CentoUI components with ease.**
 
 `centoui-cli` is the official command-line interface for [CentoUI](https://github.com/favorodera/centoui). It allows you to initialize CentoUI in your project, add new components, and manage their versions directly from your terminal.
 
 ## Commands
 
-- **`init`**: Set up a new CentoUI project (generates `centoui.config.ts` and `tokens.css`).
+- **`init`**: Set up a new CentoUI project (generates `centoui.config.ts` and `centoui.css`).
 - **`add [component]`**: Add specific components to your project. Peer dependencies install automatically.
 - **`remove [component]`**: Cleanly remove components and their dependencies.
 
@@ -18,10 +18,10 @@
 
 ```bash
 # Initialize CentoUI in your project
-npx centoui init
+pnpm dlx centoui init
 
 # Add components
-npx centoui add button dialog input select
+pnpm dlx centoui add button dialog input select
 ```
 
 ## Configuration
@@ -34,15 +34,11 @@ import { defineConfig } from "centoui"
 export default defineConfig({
   version: "1.0.0",
   componentsDir: "./src/components/centoui",
-  themeDir: "./src/assets/css/centoui.css",
+  themeFilePath: "./src/assets/css/centoui.css",
   icons: {
     check: "lucide:check",
     close: "lucide:x",
     menu: "lucide:menu",
   },
 })
-```
-
-## License
-
-[MIT](../../LICENSE) © [Favour Emeka](https://github.com/favorodera)
+```

package/dist/index.mjs

@@ -0,0 +1,232 @@
+#!/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 fsExtra from "fs-extra";
+import { addDependency } from "nypm";
+//#endregion
+//#region src/constants.ts
+/** CentoUI current package version */
+const VERSION = "0.1.1";
+/** CentoUI config file name */
+const CONFIG_FILE_NAME = "centoui.config.ts";
+/** CentoUI registry file name */
+const REGISTRY_FILE_NAME = "index.json";
+/** CentoUI core base API URL */
+const BASE_URL = "https://raw.githubusercontent.com/favorodera/centoui/main/packages/core/src";
+/** CentoUI registry files URL */
+const REGISTRY_URL = `${BASE_URL}/registry`;
+/** CentoUI theme file URL */
+const THEME_URL = `${BASE_URL}/css/centoui.css`;
+/** GitHub API fetch headers */
+const FETCH_HEADERS = {
+	"Accept": "application/vnd.github.raw+json",
+	"X-GitHub-Api-Version": "2026-03-10"
+};
+//#endregion
+//#region src/utils/package-utils.ts
+/**
+* Install packages that are missing or on a different version.
+* Reads the project's `package.json` to diff against what's already installed.
+* nypm auto-detects the package manager from lockfiles (npm / pnpm / yarn / bun).
+*
+* @param packages - Map of package name → required version
+* @param cwd - Root of the project to install into
+* @param onProgress - Optional callback fired with a status string per package
+* @returns A human-readable summary string (used as the task return value in clack)
+*/
+async function installPackages(packages, cwd, onProgress) {
+	if (Object.keys(packages).length === 0) return "No packages to install";
+	const packageJson = await fsExtra.readJson(join(cwd, "package.json")).catch(() => ({}));
+	const installedPackages = {
+		...packageJson.dependencies,
+		...packageJson.devDependencies
+	};
+	const packagesToInstall = Object.entries(packages).filter(([packageName, version]) => installedPackages[packageName] !== version).map(([packageName, version]) => `${packageName}@${version}`);
+	if (packagesToInstall.length === 0) return "All packages already up to date";
+	for (const [index, packageToInstall] of packagesToInstall.entries()) {
+		onProgress?.(`[${index + 1}/${packagesToInstall.length}] ${packageToInstall}`);
+		await addDependency(packageToInstall, {
+			cwd,
+			silent: true
+		});
+	}
+	return `Installed ${packagesToInstall.length} package(s)`;
+}
+/**
+* Validate that the given value is a non-empty string representing a valid directory path.
+* Returns `undefined` if valid, otherwise returns an error message.
+*/
+function validatePath(path) {
+	if (typeof path !== "string") return "Invalid input";
+	if (path.trim().length < 1) return "Path is required";
+}
+//#endregion
+//#region src/utils/file-system-utils.ts
+/**
+* Ask the user whether to overwrite a path that already exists.
+* Returns `true` immediately (no prompt) if the file does not exist yet.
+*
+* @param label - Human-readable path shown in the prompt message
+* @param path - The path to the file or directory to overwrite.
+*/
+async function promptOverwrite(label, path) {
+	if (!await fsExtra.pathExists(path)) return true;
+	const answer = await confirm({ message: `${label} already exists. Overwrite?` });
+	if (isCancel(answer)) {
+		cancel(`${label} operation cancelled.`);
+		process.exit(0);
+	}
+	return answer;
+}
+//#endregion
+//#region src/utils/config-utils.ts
+/**
+* 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.
+* @returns The default user-defined CentoUI config file template as a string.
+*/
+function generateDefaultUserConfigTemplate(themeFilePath, componentsDir) {
+	return `import { defineConfig } from 'centoui'
+
+export default defineConfig({
+  version: '${VERSION}',
+  componentsDir: '${componentsDir}',
+  themeFilePath: '${themeFilePath}',
+  icons: {
+    check: 'lucide:check',
+    close: 'lucide:x',
+    menu: 'lucide:menu',
+  },
+})
+`;
+}
+//#endregion
+//#region src/utils/registry-utils.ts
+let registryCache = null;
+/**
+* Fetches the complete component registry once and caches it in memory.
+*
+* @returns The complete registry including components and globals.
+* @throws If the network request fails or returns a non-OK status
+*/
+async function fetchRegistry() {
+	if (registryCache) return registryCache;
+	const requestUrl = `${REGISTRY_URL}/${REGISTRY_FILE_NAME}`;
+	const response = await fetch(requestUrl, { headers: FETCH_HEADERS });
+	if (!response.ok) throw new Error(`${response.status}: ${response.statusText}`);
+	const registry = await response.json();
+	registryCache = registry;
+	return registry;
+}
+/**
+* Fetches the theme file from the registry.
+*
+* @returns The raw source code of the theme file
+*/
+async function fetchThemeFile() {
+	const response = await fetch(THEME_URL, { headers: FETCH_HEADERS });
+	if (!response.ok) throw new Error(`${response.status}: ${response.statusText}`);
+	return response.text();
+}
+//#endregion
+//#region src/commands/init.ts
+function init() {
+	return defineCommand({
+		meta: {
+			name: "init",
+			description: "Initialize a new CentoUI project"
+		},
+		async run() {
+			try {
+				const cwd = process.cwd();
+				intro("CentoUI — Initialize project");
+				const directories = await group({
+					componentDir: () => text({
+						message: "Directory to store components",
+						initialValue: "src/components/centoui",
+						validate: validatePath
+					}),
+					themeFilePath: () => text({
+						message: "Directory to store theme CSS file",
+						initialValue: "src/assets/css/centoui.css",
+						validate: validatePath
+					})
+				}, { onCancel: () => {
+					cancel("Initialization cancelled.");
+					process.exit(0);
+				} });
+				const configPath = join(cwd, CONFIG_FILE_NAME);
+				const themePath = join(cwd, directories.themeFilePath);
+				const componentsPath = join(cwd, directories.componentDir);
+				const shouldWriteConfig = await promptOverwrite(CONFIG_FILE_NAME, configPath);
+				const shouldWriteTheme = await promptOverwrite(directories.themeFilePath, themePath);
+				const shouldWriteComponents = await promptOverwrite(directories.componentDir, componentsPath);
+				let registry;
+				await tasks([
+					{
+						title: `Writing ${CONFIG_FILE_NAME}`,
+						task: async () => {
+							if (!shouldWriteConfig) return `Skipped writing ${CONFIG_FILE_NAME}, already exists`;
+							await fsExtra.outputFile(configPath, generateDefaultUserConfigTemplate(directories.themeFilePath, directories.componentDir), "utf-8");
+							return `${CONFIG_FILE_NAME} written`;
+						}
+					},
+					{
+						title: "Fetching theme CSS",
+						task: async () => {
+							if (!shouldWriteTheme) return "Skipped fetching theme CSS, already exists";
+							const themeFile = await fetchThemeFile();
+							await fsExtra.outputFile(themePath, themeFile, "utf-8");
+							return `${directories.themeFilePath} written`;
+						}
+					},
+					{
+						title: "Preparing components directory",
+						task: async () => {
+							if (!shouldWriteComponents) return "Skipped preparing components directory. already exists.";
+							await fsExtra.emptyDir(componentsPath);
+							return `${directories.componentDir} ready`;
+						}
+					},
+					{
+						title: "Fetching registry",
+						task: async () => {
+							registry = await fetchRegistry();
+							return "Registry index loaded";
+						}
+					},
+					{
+						title: "Installing global dependencies",
+						task: async (message) => {
+							return installPackages(registry.globals.packageDeps, cwd, message);
+						}
+					}
+				]);
+				note([
+					`Config     > ${configPath}`,
+					`Theme      > ${themePath}`,
+					`Components > ${componentsPath}`,
+					"",
+					"Run 'centoui add button' to install your first component"
+				].join("\n"), "CentoUI initialized");
+				outro("All Set!");
+			} catch (error) {
+				log.error(`Failed to build registry: ${error}`);
+				process.exit(1);
+			}
+		}
+	});
+}
+//#endregion
+//#region src/index.ts
+runMain(defineCommand({
+	meta: {
+		name: "centoui",
+		version: VERSION
+	},
+	subCommands: { init }
+}));
+//#endregion
+export {};

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "centoui-cli",
   "type": "module",
-  "version": "0.0.0",
+  "version": "0.1.1",
+  "private": false,
   "description": "Official CLI for CentoUI.",
   "author": "Favour Emeka <favorodera@gmail.com>",
   "license": "MIT",
@@ -17,7 +18,7 @@
     "access": "public"
   },
   "exports": {
-    ".": "./dist/index.js",
+    ".": "./dist/index.mjs",
     "./package.json": "./package.json"
   },
   "types": "./dist/types.d.mts",
@@ -25,18 +26,19 @@
     "dist"
   ],
   "bin": {
-    "centoui": "./dist/index.js"
+    "centoui": "./dist/index.mjs"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",
-    "tsdown": "^0.21.7"
+    "tsdown": "^0.21.7",
+    "type-fest": "^5.6.0"
   },
   "dependencies": {
+    "@clack/prompts": "^1.2.0",
     "citty": "^0.2.2",
     "fs-extra": "^11.3.4",
     "nypm": "^0.6.6",
-    "pathe": "^2.0.3",
-    "@clack/prompts": "^1.2.0"
+    "pathe": "^2.0.3"
   },
   "engines": {
     "node": ">=22.0.0"

package/dist/index.js

@@ -1,20 +0,0 @@
-#!/usr/bin/env node
-import { defineCommand, runMain } from "citty";
-//#endregion
-//#region src/constants.ts
-/** CentoUI current package version */
-const VERSION = "0.0.0";
-/** CentoUI core base API URL */
-const BASE_URL = `https://raw.githubusercontent.com/favorodera/centoui/refs/tags/v${VERSION}/packages/core/src`;
-`${BASE_URL}`;
-`${BASE_URL}`;
-//#endregion
-//#region src/index.ts
-runMain(defineCommand({
-	meta: {
-		name: "centoui",
-		version: VERSION
-	},
-	subCommands: {}
-}));
-//#endregion