centoui-cli 1.0.0-alpha.35 → 1.0.0-alpha.37

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.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.35";
+const VERSION = "1.0.0-alpha.37";
 /** File name for the user-side CentoUI config (created by `centoui init`). */
 const CONFIG_FILE_NAME = "centoui.config.ts";
 /**
@@ -26,7 +26,11 @@ const REGISTRY_INDEX_URL = `${`${CORE_SRC_BASE_URL}/registry`}/index.json`;
 * This file is written to the user's project during `centoui init`.
 */
 const THEME_CSS_URL = `${CORE_SRC_BASE_URL}/defaults/centoui.css`;
-`${CORE_SRC_BASE_URL}`;
+/**
+* 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`.
@@ -379,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
 /**
@@ -455,7 +478,8 @@ function init() {
 						title: "Writing utils file",
 						task: async () => {
 							if (!shouldWriteUtils) return `Skipped — "${directories.utilsFilePath}" already exists`;
-							await fsExtra.outputFile(utilsPath, "", "utf-8");
+							const utilsContent = await fetchUtilsFileContent();
+							await fsExtra.outputFile(utilsPath, utilsContent, "utf-8");
 							return `${directories.utilsFilePath} written`;
 						}
 					},

package/package.json

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