@styleframe/cli 1.0.1 → 1.0.2

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @styleframe/cli
 
+## 1.0.2
+
+### Patch Changes
+
+- [#30](https://github.com/styleframe-dev/styleframe/pull/30) [`68cd004`](https://github.com/styleframe-dev/styleframe/commit/68cd004b04395797876b5e805c0b910d6b665f35) Thanks [@alexgrozav](https://github.com/alexgrozav)! - feat: Add support for modifying Vite and Nuxt configuration files
+  feat: Add fallback installation guide links
+- Updated dependencies [[`68cd004`](https://github.com/styleframe-dev/styleframe/commit/68cd004b04395797876b5e805c0b910d6b665f35)]:
+  - @styleframe/loader@1.0.2
+
 ## 1.0.1
 
 ### Patch Changes

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Alex Grozav
+
+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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@styleframe/cli",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "A command-line interface for styleframe.",
   "type": "module",
   "types": "./dist/index.d.ts",
@@ -16,18 +16,20 @@
   "dependencies": {
     "citty": "^0.1.6",
     "consola": "^3.0.0-2",
-    "@styleframe/loader": "^1.0.1"
+    "magicast": "^0.5.0",
+    "@styleframe/loader": "^1.0.2"
   },
   "devDependencies": {
+    "@vitest/coverage-v8": "^3.2.4",
     "tsx": "^4.20.6",
     "typescript": "^5.8.3",
     "vite": "^7.0.6",
     "vite-plugin-dts": "^4.5.4",
     "vite-plugin-node": "^7.0.0",
     "vitest": "^3.2.4",
-    "@styleframe/config-vite": "^1.0.1",
     "@styleframe/config-typescript": "^1.0.1",
-    "@styleframe/core": "^1.0.1"
+    "@styleframe/core": "^1.0.1",
+    "@styleframe/config-vite": "^1.0.1"
   },
   "homepage": "https://github.com/styleframe-dev/styleframe#readme",
   "bugs": {
@@ -38,14 +40,17 @@
     "url": "git+https://github.com/styleframe-dev/styleframe.git"
   },
   "author": "Alex Grozav <alex@styleframe.dev>",
+  "overrides": {
+    "vite": "npm:rolldown-vite@latest"
+  },
   "scripts": {
     "dev": "vite build --watch",
     "prebuild": "tsx ./scripts/prebuild.ts",
     "build": "pnpm run prebuild && pnpm typecheck && vite build",
     "typecheck": "tsc --noEmit",
-    "test": "vitest run",
+    "test": "vitest run --passWithNoTests",
     "test:dev": "vitest --watch",
-    "playground:init": "tsx src/playground/init.ts",
-    "playground:build": "tsx src/playground/build.ts"
+    "playground:init": "tsx playground/init.ts",
+    "playground:build": "tsx playground/build.ts"
   }
 }

package/{src/playground → playground}/build.ts

@@ -1,5 +1,5 @@
 import path from "node:path";
-import build from "../commands/build";
+import build from "../src/commands/build";
 
 const __dirname = new URL(".", import.meta.url).pathname;
 

package/{src/playground → playground}/init.ts

@@ -1,6 +1,6 @@
 import { copyFile } from "node:fs/promises";
 import path from "node:path";
-import init from "../commands/init";
+import init from "../src/commands/init";
 
 const __dirname = new URL(".", import.meta.url).pathname;
 
@@ -10,6 +10,11 @@ const __dirname = new URL(".", import.meta.url).pathname;
 		path.join(__dirname, "package.json"),
 	);
 
+	await copyFile(
+		path.join(__dirname, "vite.config.template.ts"),
+		path.join(__dirname, "vite.config.ts"),
+	);
+
 	// biome-ignore lint/suspicious/noExplicitAny: No need for explicit type
 	await init.run?.({ args: { cwd: __dirname } } as any);
 })();

package/playground/vite.config.template.ts

@@ -0,0 +1,5 @@
+import { defineConfig } from "vite";
+
+const __dirname = new URL(".", import.meta.url).pathname;
+
+export default defineConfig({});

package/src/commands/build.ts

@@ -1,5 +1,5 @@
 import path from "node:path";
-import { build, loadConfiguration } from "@styleframe/loader";
+import { build, loadConfigurationFromPath } from "@styleframe/loader";
 import { defineCommand } from "citty";
 import consola from "consola";
 
@@ -22,24 +22,30 @@ export default defineCommand({
 			alias: ["o", "out"],
 			valueHint: "path",
 		},
+		clean: {
+			type: "boolean",
+			description: "Clean output directory before build",
+			default: false,
+		},
 	},
 	async run({ args }) {
-		const entryPath = path.resolve(args.entry);
-		const cwd = path.dirname(entryPath);
-		const name = path.basename(entryPath).replace(/(\.config)?(\.ts)?$/, "");
-
 		consola.info(
-			`Loading configuration from "${path.relative(process.cwd(), entryPath)}"...`,
+			`Loading configuration from "${path.relative(process.cwd(), path.resolve(args.entry))}"...`,
 		);
 
-		const instance = await loadConfiguration({ cwd, name });
+		const instance = await loadConfigurationFromPath(args.entry);
 
 		consola.info("Building styleframe...");
 
-		await build(instance, {
-			outputDir: args.outputDir,
-		});
+		try {
+			await build(instance, {
+				outputDir: args.outputDir,
+				clean: args.clean,
+			});
 
-		consola.success("Styleframe built successfully!");
+			consola.success("Styleframe built successfully!");
+		} catch (error) {
+			consola.error("Failed to build Styleframe:", error);
+		}
 	},
 });

package/src/commands/init/nuxt.ts

@@ -0,0 +1,27 @@
+import consola from "consola";
+import path from "path";
+import {
+	loadFile as loadMagicastFile,
+	writeFile as writeMagicastFile,
+} from "magicast";
+import { addNuxtModule } from "magicast/helpers";
+
+export async function initializeNuxtFrameworkFile(cwd: string) {
+	consola.success("Nuxt environment detected.");
+	const configFilePath = path.join(cwd, "nuxt.config.ts");
+
+	try {
+		const mod = await loadMagicastFile(configFilePath);
+
+		addNuxtModule(mod, "styleframe/nuxt", "styleframe");
+
+		await writeMagicastFile(mod, configFilePath);
+
+		consola.success(`Updated Nuxt config file.`);
+	} catch (error) {
+		consola.error(`Failed to update Nuxt config file: ${error}`);
+		consola.error(
+			"Please add `'styleframe/nuxt'` to your nuxt modules array manually.",
+		);
+	}
+}

package/src/commands/init/vite.ts

@@ -0,0 +1,33 @@
+import consola from "consola";
+import path from "path";
+import {
+	loadFile as loadMagicastFile,
+	writeFile as writeMagicastFile,
+} from "magicast";
+import { addVitePlugin } from "magicast/helpers";
+
+export async function initializeViteFrameworkFile(cwd: string) {
+	consola.success("Vite environment detected.");
+	const configFilePath = path.join(cwd, "vite.config.ts");
+
+	try {
+		const mod = await loadMagicastFile(configFilePath);
+
+		addVitePlugin(mod, {
+			from: "styleframe/plugins/vite",
+			constructor: "styleframePlugin",
+			imported: "default",
+		});
+
+		await writeMagicastFile(mod, configFilePath);
+
+		consola.success(`Updated Vite config file.`);
+	} catch (error) {
+		consola.error(`Failed to update Vite config file.`);
+		consola.log(error);
+		console.log("");
+		consola.log(
+			"Please add `import styleframePlugin from 'styleframe/vite';` and register it manually.",
+		);
+	}
+}

package/src/commands/init.ts

@@ -3,6 +3,9 @@ import { defineCommand } from "citty";
 import { readFile, writeFile } from "fs/promises";
 import path from "path";
 import { fileExists } from "../utils";
+import { initializeViteFrameworkFile } from "./init/vite";
+import { initializeNuxtFrameworkFile } from "./init/nuxt";
+import { DOCS_INSTALLATION_CUSTOM_URL } from "../constants";
 
 const styleframeConfigTemplate = `import { styleframe } from "styleframe";
 
@@ -31,12 +34,9 @@ export async function addPackageJsonDependencies(cwd: string) {
 	if (await fileExists(packageJsonPath)) {
 		const packageJson = JSON.parse(await readFile(packageJsonPath, "utf8"));
 
-		if (!packageJson.dependencies) packageJson.dependencies = {};
-		packageJson.dependencies["styleframe"] = "^1.0.0";
-		packageJson.dependencies["@styleframe/theme"] = "^1.0.0";
-
 		if (!packageJson.devDependencies) packageJson.devDependencies = {};
-		packageJson.devDependencies["@styleframe/cli"] = "^1.0.0";
+		packageJson.devDependencies["styleframe"] = "^1.0.0";
+		packageJson.devDependencies["@styleframe/theme"] = "^1.0.0";
 
 		await writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2));
 
@@ -48,6 +48,19 @@ export async function addPackageJsonDependencies(cwd: string) {
 	}
 }
 
+export async function initializeFrameworkFile(cwd: string) {
+	if (await fileExists(path.join(cwd, "vite.config.ts"))) {
+		await initializeViteFrameworkFile(cwd);
+	} else if (await fileExists(path.join(cwd, "nuxt.config.ts"))) {
+		await initializeNuxtFrameworkFile(cwd);
+	} else {
+		consola.warn(
+			"No framework file detected. Read more about setting up styleframe manually.",
+			DOCS_INSTALLATION_CUSTOM_URL,
+		);
+	}
+}
+
 export default defineCommand({
 	meta: {
 		name: "init",
@@ -70,5 +83,6 @@ export default defineCommand({
 
 		await initializeConfigFile(cwd);
 		await addPackageJsonDependencies(cwd);
+		await initializeFrameworkFile(cwd);
 	},
 });

package/src/constants.ts

@@ -0,0 +1,7 @@
+export const HOMEPAGE_URL = "https://styleframe.dev";
+export const DOCS_URL = `${HOMEPAGE_URL}/docs`;
+export const DOCS_INSTALLATION_VITE_URL = `${DOCS_URL}/getting-started/installation/vite`;
+export const DOCS_MANUAL_INSTALLATION_VITE_URL = `${DOCS_URL}/getting-started/installation/manual/vite`;
+export const DOCS_INSTALLATION_NUXT_URL = `${DOCS_URL}/getting-started/installation/nuxt`;
+export const DOCS_MANUAL_INSTALLATION_NUXT_URL = `${DOCS_URL}/getting-started/installation/manual/nuxt`;
+export const DOCS_INSTALLATION_CUSTOM_URL = `${DOCS_URL}/getting-started/installation/custom`;

package/src/package.ts

@@ -1,2 +1,2 @@
-export const version = "1.0.0";
+export const version = "1.0.1";
 export const description = "A command-line interface for styleframe.";

package/tsconfig.json

@@ -3,5 +3,10 @@
 	"compilerOptions": {
 		"tsBuildInfoFile": ".tsbuildinfo"
 	},
-	"include": ["src/**/*.ts", "tsup.config.ts", "vite.config.ts"]
+	"include": [
+		"src/**/*.ts",
+		"playground/**/*.ts",
+		"tsdown.config.ts",
+		"vite.config.ts"
+	]
 }

package/src/playground/styleframe/index.css

@@ -1,3 +0,0 @@
-:root {
-	--color--primary: blue;
-}