tailwind-to-style 2.8.4 → 2.8.5

package/README.md

@@ -7,10 +7,11 @@
 
 `tailwind-to-style` is a JavaScript library designed to convert Tailwind CSS utility classes into inline styles or JavaScript objects. This is especially useful when you need to dynamically apply styles to elements in frameworks like React, where inline styles or style objects are frequently used.
 
-The library exposes two main functions:
+The library exposes two main functions and a CLI tool:
 
 1. **`tws`**: Converts Tailwind CSS classes into inline CSS styles or JavaScript objects (JSON).
 2. **`twsx`**: A more advanced function that allows you to define nested and complex styles similar to SCSS, including support for responsive, state variants, and grouping.
+3. **`twsx-cli`**: A command-line tool for generating CSS files from `twsx.*.js` files with watch mode support.
 
 ## Installation
 
@@ -547,38 +548,90 @@ import './styles/twsx.button.css';
 
 In addition to using the Vite/Webpack plugin, you can also use a Node.js script to generate CSS files from `twsx.*.js` files manually or as part of your build workflow.
 
-### Script: tailwind-to-style/lib/build-twsx.js
+### Script: tailwind-to-style/lib/twsx-cli.js (Legacy)
+
+> **💡 Recommended:** Use `npx twsx-cli` instead of calling the script directly.
 
 This script will recursively scan for all `twsx.*.js` files in your project, generate CSS using the `twsx` function, and write individual CSS files to the specified output directory.
 
 #### How to Use
 
 1. Create JS files with `twsx.` prefix containing style objects anywhere in your `src/` folder (e.g., `src/components/twsx.card.js`).
-2. Run the script with the following command:
 
+2. **One-time Build:**
+```bash
+node tailwind-to-style/lib/twsx-cli.js
+```
+
+3. **Watch Mode (Auto-rebuild on file changes):**
 ```bash
-node tailwind-to-style/lib/build-twsx.js
+node tailwind-to-style/lib/twsx-cli.js --watch
 ```
 
 You can configure input and output directories using environment variables:
 ```bash
-TWSX_INPUT_DIR=src TWSX_OUTPUT_DIR=dist/styles node tailwind-to-style/lib/build-twsx.js
+TWSX_INPUT_DIR=src TWSX_OUTPUT_DIR=dist/styles node tailwind-to-style/lib/twsx-cli.js --watch
 ```
 
-3. After running, individual CSS files will be available in the output directory (default: `src/styles/`):
+4. After running, individual CSS files will be available in the output directory (default: `src/styles/`):
 
 ```
 src/styles/twsx.card.css
 src/styles/twsx.button.css
 ```
 
-4. Import the generated CSS files in your components:
+5. Import the generated CSS files in your components:
 
 ```js
 import './styles/twsx.card.css';
 import './styles/twsx.button.css';
 ```
 
+#### Usage in Different Projects
+
+**React/Next.js/Vue/Any Project:**
+
+1. Install the package:
+```bash
+npm install tailwind-to-style
+```
+
+2. Add to your `package.json`:
+```json
+{
+  "scripts": {
+    "twsx:build": "node node_modules/tailwind-to-style/lib/twsx-cli.js",
+    "twsx:watch": "node node_modules/tailwind-to-style/lib/twsx-cli.js --watch",
+    "dev": "npm run twsx:watch & next dev"
+  }
+}
+```
+
+3. For development with auto-rebuild:
+```bash
+npm run twsx:watch
+```
+
+4. For production build:
+```bash
+npm run twsx:build
+```
+
+**VS Code Integration:**
+Add to your workspace settings (`.vscode/settings.json`):
+```json
+{
+  "emeraldwalk.runonsave": {
+    "commands": [
+      {
+        "match": "twsx\\..*\\.js$",
+        "cmd": "npm run twsx:build"
+      }
+    ]
+  }
+}
+```
+
 #### Automatic Integration
 
 You can add this script to the build section in your `package.json`:
@@ -586,7 +639,7 @@ You can add this script to the build section in your `package.json`:
 ```json
 {
   "scripts": {
-    "build-css": "node tailwind-to-style/lib/build-twsx.js"
+    "build-css": "node tailwind-to-style/lib/twsx-cli.js"
   }
 }
 ```

package/dist/index.browser.js

@@ -1,5 +1,5 @@
 /**
- * tailwind-to-style v2.8.4
+ * tailwind-to-style v2.8.5
  * Convert tailwind classes to inline style
  * 
  * @author Bigetion

package/dist/index.cjs

@@ -1,5 +1,5 @@
 /**
- * tailwind-to-style v2.8.4
+ * tailwind-to-style v2.8.5
  * Convert tailwind classes to inline style
  * 
  * @author Bigetion

package/dist/index.esm.js

@@ -1,5 +1,5 @@
 /**
- * tailwind-to-style v2.8.4
+ * tailwind-to-style v2.8.5
  * Convert tailwind classes to inline style
  * 
  * @author Bigetion

package/lib/twsx-cli.js

@@ -0,0 +1,114 @@
+import fs from "fs";
+import path from "path";
+import { pathToFileURL } from "url";
+import { twsx } from "tailwind-to-style";
+import chokidar from "chokidar";
+
+function findTwsxFiles(dir, files = []) {
+  const items = fs.readdirSync(dir);
+  for (const item of items) {
+    const fullPath = path.join(dir, item);
+    const stat = fs.statSync(fullPath);
+    if (stat.isDirectory()) {
+      findTwsxFiles(fullPath, files);
+    } else if (item.startsWith("twsx.") && item.endsWith(".js")) {
+      files.push(fullPath);
+    }
+  }
+  return files;
+}
+
+async function buildTwsx(inputDir, outputDir) {
+  try {
+    const twsxFiles = findTwsxFiles(inputDir);
+    const generatedCssFiles = [];
+
+    // Generate CSS from JS files
+    for (const filePath of twsxFiles) {
+      try {
+        const styleModule = await import(
+          pathToFileURL(filePath).href + `?update=${Date.now()}`
+        );
+        const styleObj = styleModule.default || styleModule;
+        const css = twsx(styleObj, { inject: false });
+        const fileName = path.basename(filePath).replace(/\.js$/, ".css");
+        const cssFilePath = path.join(outputDir, fileName);
+        fs.writeFileSync(cssFilePath, css);
+        generatedCssFiles.push(fileName);
+        console.log(`[twsx-cli] CSS written to ${cssFilePath}`);
+      } catch (err) {
+        console.error(
+          `[twsx-cli] Error importing or processing ${filePath}:`,
+          err
+        );
+      }
+    }
+
+    // Clean up orphaned CSS files
+    if (fs.existsSync(outputDir)) {
+      const existingCssFiles = fs
+        .readdirSync(outputDir)
+        .filter((file) => file.startsWith("twsx.") && file.endsWith(".css"));
+
+      for (const cssFile of existingCssFiles) {
+        if (!generatedCssFiles.includes(cssFile)) {
+          const cssFilePath = path.join(outputDir, cssFile);
+          fs.unlinkSync(cssFilePath);
+          console.log(`[twsx-cli] Removed orphaned CSS: ${cssFilePath}`);
+        }
+      }
+    }
+  } catch (err) {
+    console.error("[twsx-cli] Error scanning for twsx files:", err);
+  }
+}
+
+const inputDir =
+  process.env.TWSX_INPUT_DIR || path.resolve(process.cwd(), "src");
+const outputDir =
+  process.env.TWSX_OUTPUT_DIR || path.resolve(process.cwd(), "src/styles");
+const watchMode = process.argv.includes("--watch") || process.env.TWSX_WATCH === "true";
+
+if (!fs.existsSync(outputDir)) {
+  fs.mkdirSync(outputDir, { recursive: true });
+}
+
+// Initial build
+(async () => {
+  try {
+    await buildTwsx(inputDir, outputDir);
+    console.log(`[twsx-cli] Initial build completed`);
+
+    if (watchMode) {
+      console.log(`[twsx-cli] Watching for changes in ${inputDir}...`);
+      
+      const watcher = chokidar.watch(`${inputDir}/**/twsx.*.js`, {
+        ignored: /node_modules/,
+        persistent: true,
+      });
+
+      watcher
+        .on("change", async (filePath) => {
+          console.log(`[twsx-cli] File changed: ${filePath}`);
+          await buildTwsx(inputDir, outputDir);
+        })
+        .on("add", async (filePath) => {
+          console.log(`[twsx-cli] File added: ${filePath}`);
+          await buildTwsx(inputDir, outputDir);
+        })
+        .on("unlink", async (filePath) => {
+          console.log(`[twsx-cli] File removed: ${filePath}`);
+          await buildTwsx(inputDir, outputDir);
+        });
+
+      // Keep the process alive
+      process.on("SIGINT", () => {
+        console.log("\n[twsx-cli] Stopping watcher...");
+        watcher.close();
+        process.exit(0);
+      });
+    }
+  } catch (err) {
+    console.error("[twsx-cli] Error writing CSS:", err);
+  }
+})();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tailwind-to-style",
-  "version": "2.8.4",
+  "version": "2.8.5",
   "description": "Convert tailwind classes to inline style",
   "type": "module",
   "main": "dist/index.cjs",
@@ -15,6 +15,9 @@
     "lib",
     "twsx.css"
   ],
+  "bin": {
+    "twsx-cli": "./lib/twsx-cli.js"
+  },
   "scripts": {
     "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js --passWithNoTests",
     "build": "rollup -c rollup.config.js",
@@ -54,6 +57,7 @@
     "@rollup/plugin-terser": "^0.4.4",
     "babel-jest": "^28.1.0",
     "babel-loader": "^10.0.0",
+    "chokidar": "^4.0.1",
     "eslint": "^8.16.0",
     "jest": "^28.1.0",
     "prettier": "^3.5.3",

package/lib/build-twsx.js

@@ -1,59 +0,0 @@
-import fs from "fs";
-import path from "path";
-import { pathToFileURL } from "url";
-import { twsx } from "tailwind-to-style";
-
-function findTwsxFiles(dir, files = []) {
-  const items = fs.readdirSync(dir);
-  for (const item of items) {
-    const fullPath = path.join(dir, item);
-    const stat = fs.statSync(fullPath);
-    if (stat.isDirectory()) {
-      findTwsxFiles(fullPath, files);
-    } else if (item.startsWith("twsx.") && item.endsWith(".js")) {
-      files.push(fullPath);
-    }
-  }
-  return files;
-}
-
-async function buildTwsx(inputDir, outputDir) {
-  try {
-    const twsxFiles = findTwsxFiles(inputDir);
-    for (const filePath of twsxFiles) {
-      try {
-        const styleModule = await import(
-          pathToFileURL(filePath).href + `?update=${Date.now()}`
-        );
-        const styleObj = styleModule.default || styleModule;
-        const css = twsx(styleObj, { inject: false });
-        const fileName = path.basename(filePath).replace(/\.js$/, ".css");
-        const cssFilePath = path.join(outputDir, fileName);
-        fs.writeFileSync(cssFilePath, css);
-      } catch (err) {
-        console.error(
-          `[build-twsx] Error importing or processing ${filePath}:`,
-          err
-        );
-      }
-    }
-  } catch (err) {
-    console.error("[build-twsx] Error scanning for twsx files:", err);
-  }
-}
-
-const inputDir =
-  process.env.TWSX_INPUT_DIR || path.resolve(process.cwd(), "src");
-const outputDir =
-  process.env.TWSX_OUTPUT_DIR || path.resolve(process.cwd(), "src/styles");
-if (!fs.existsSync(outputDir)) {
-  fs.mkdirSync(outputDir, { recursive: true });
-}
-
-(async () => {
-  try {
-    await buildTwsx(inputDir, outputDir);
-  } catch (err) {
-    console.error("[build-twsx] Error writing CSS:", err);
-  }
-})();