centoui-cli 0.0.0 → 0.0.1

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.0.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/refs/tags/v${VERSION}/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,7 @@
 {
   "name": "centoui-cli",
   "type": "module",
-  "version": "0.0.0",
+  "version": "0.0.1",
   "description": "Official CLI for CentoUI.",
   "author": "Favour Emeka <favorodera@gmail.com>",
   "license": "MIT",
@@ -17,7 +17,7 @@
     "access": "public"
   },
   "exports": {
-    ".": "./dist/index.js",
+    ".": "./dist/index.mjs",
     "./package.json": "./package.json"
   },
   "types": "./dist/types.d.mts",
@@ -25,18 +25,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