centoui-cli 1.0.0-alpha.34 → 1.0.0-alpha.36

package/README.md

@@ -24,11 +24,12 @@ pnpm dlx centoui init
 
 **What it does:**
 
-1. Prompts you for a component directory (default: `src/components/centoui`) and theme CSS path (default: `src/assets/css/centoui.css`).
+1. Prompts you for a component directory (default: `src/components/centoui`), a utils file path (default: `src/utils/centoui-utils.ts`), and theme CSS path (default: `src/assets/css/centoui.css`).
 2. Writes `centoui.config.ts` with your chosen paths and default icon mappings.
 3. Fetches and writes the `centoui.css` theme file with all light/dark color tokens.
-4. Creates the component directory.
-5. Installs global peer dependencies (`vue`, `reka-ui`, `tailwindcss`, etc.).
+4. Writes the `centoui-utils.ts` file with all utility functions.
+5. Creates the component directory.
+6. Installs global peer dependencies (`vue`, `reka-ui`, `tailwindcss`, etc.).
 
 ---
 
@@ -93,6 +94,7 @@ import { defineConfig } from "centoui"
 export default defineConfig({
   componentsDir: "./src/components/centoui",
   themeFilePath: "./src/assets/css/centoui.css",
+  utilsFilePath: "./src/utils/centoui-utils.ts",
   icons: {
     check: "lucide:check",
     close: "lucide:x",

package/dist/index.d.mts

@@ -49,7 +49,8 @@ type Registry = {
  */
 type CentoUIConfig = {
   /** Relative path (from project root) to the directory where components are installed. */componentsDir: string; /** Relative path (from project root) to the CSS file that receives theme and component styles. */
-  themeFilePath: string;
+  themeFilePath: string; /** Relative path (from project root) to the utils file. */
+  utilsFilePath: string;
   /**
    * Maps internal CentoUI icon slot names to Iconify icon IDs.
    * Components reference icon slots by their internal name so you can swap icon libraries freely.

package/dist/index.mjs

@@ -8,7 +8,7 @@ import { loadConfig } from "c12";
 //#endregion
 //#region src/constants.ts
 /** CentoUI current package version, sourced directly from package.json. */
-const VERSION = "1.0.0-alpha.34";
+const VERSION = "1.0.0-alpha.36";
 /** File name for the user-side CentoUI config (created by `centoui init`). */
 const CONFIG_FILE_NAME = "centoui.config.ts";
 /**
@@ -27,6 +27,11 @@ const REGISTRY_INDEX_URL = `${`${CORE_SRC_BASE_URL}/registry`}/index.json`;
 */
 const THEME_CSS_URL = `${CORE_SRC_BASE_URL}/defaults/centoui.css`;
 /**
+* Full URL to the utils file.
+* This file is written to the user's project during `centoui init`.
+*/
+const UTILS_FILE_URL = `${CORE_SRC_BASE_URL}/defaults/utils.ts`;
+/**
 * Full URL to the default values file for the CentoUI config.
 * The contents of this file are written to the user's project during `centoui init`.
 */
@@ -271,14 +276,16 @@ function extractInnerConfigContent(fileContent) {
 *
 * @param themeFilePath - Relative path (from project root) where the CSS theme file lives.
 * @param componentsDir - Relative path (from project root) where components will be installed.
+* @param utilsFilePath - Relative path (from project root) where the utils file lives.
 * @returns A string containing the complete TypeScript source for the config file.
 */
-async function buildUserDefaultConfigFileContent(themeFilePath, componentsDir) {
+async function buildUserDefaultConfigFileContent(themeFilePath, componentsDir, utilsFilePath) {
 	return `import { defineConfig } from 'centoui'
 
 export default defineConfig({
   componentsDir: '${componentsDir}',
   themeFilePath: '${themeFilePath}',
+  utilsFilePath: '${utilsFilePath}',
 ${extractInnerConfigContent(await fetchDefaultConfig())}
 })
 `;
@@ -376,6 +383,25 @@ async function fetchThemeCSSContent() {
 	if (!response.ok) throw new Error(`[fetchThemeCSSContent] Server returned ${response.status} ${response.statusText} (URL: ${THEME_CSS_URL})`);
 	return response.text();
 }
+/**
+* Fetches the raw content of the CentoUI utils file from GitHub.
+*
+* This is the file written to the user's project during `centoui init` and
+* contains all global utils for every component.
+*
+* @returns Raw UTF-8 content of the utils file.
+* @throws If the network request fails or the server returns a non-2xx status.
+*/
+async function fetchUtilsFileContent() {
+	let response;
+	try {
+		response = await fetch(UTILS_FILE_URL, { headers: GITHUB_RAW_FETCH_HEADERS });
+	} catch (error) {
+		throw new Error(`[fetchUtilsFileContent] Network request for utils file failed: ${error}`);
+	}
+	if (!response.ok) throw new Error(`[fetchUtilsFileContent] Server returned ${response.status} ${response.statusText} (URL: ${UTILS_FILE_URL})`);
+	return response.text();
+}
 //#endregion
 //#region src/commands/init.ts
 /**
@@ -410,6 +436,11 @@ function init() {
 						message: "Path for the theme CSS file",
 						initialValue: "src/assets/css/centoui.css",
 						validate: validateNonEmptyPath
+					}),
+					utilsFilePath: () => text({
+						message: "Path for the utils file",
+						initialValue: "src/utils/centoui-utils.ts",
+						validate: validateNonEmptyPath
 					})
 				}, { onCancel: () => {
 					cancel("Initialization cancelled.");
@@ -418,16 +449,18 @@ function init() {
 				const configPath = join(cwd, CONFIG_FILE_NAME);
 				const themePath = join(cwd, directories.themeFilePath);
 				const componentsPath = join(cwd, directories.componentDir);
+				const utilsPath = join(cwd, directories.utilsFilePath);
 				const shouldWriteConfig = await confirmOverwriteIfExists(CONFIG_FILE_NAME, configPath);
 				const shouldWriteTheme = await confirmOverwriteIfExists(directories.themeFilePath, themePath);
 				const shouldWriteComponentsDir = await confirmOverwriteIfExists(directories.componentDir, componentsPath);
+				const shouldWriteUtils = await confirmOverwriteIfExists(directories.utilsFilePath, utilsPath);
 				let registry;
 				await tasks([
 					{
 						title: "Fetching config defaults",
 						task: async () => {
 							if (!shouldWriteConfig) return `Skipped — "${CONFIG_FILE_NAME}" already exists`;
-							const userConfigContent = await buildUserDefaultConfigFileContent(directories.themeFilePath, directories.componentDir);
+							const userConfigContent = await buildUserDefaultConfigFileContent(directories.themeFilePath, directories.componentDir, directories.utilsFilePath);
 							await fsExtra.outputFile(configPath, userConfigContent, "utf-8");
 							return `${CONFIG_FILE_NAME} written`;
 						}
@@ -441,6 +474,15 @@ function init() {
 							return `${directories.themeFilePath} written`;
 						}
 					},
+					{
+						title: "Writing utils file",
+						task: async () => {
+							if (!shouldWriteUtils) return `Skipped — "${directories.utilsFilePath}" already exists`;
+							const utilsContent = await fetchUtilsFileContent();
+							await fsExtra.outputFile(utilsPath, utilsContent, "utf-8");
+							return `${directories.utilsFilePath} written`;
+						}
+					},
 					{
 						title: "Preparing components directory",
 						task: async () => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "centoui-cli",
   "type": "module",
-  "version": "1.0.0-alpha.34",
+  "version": "1.0.0-alpha.36",
   "private": false,
   "description": "Official CLI for CentoUI.",
   "keywords": [