Update README.md

Author: sakibweb

README.md

@@ -1,4 +1,32 @@
-# CSS2PHP
+# CSS2PHP Converter
+
+A powerful Python tool for converting CSS files and URLs into PHP arrays with advanced parsing and merging capabilities.
+
+![Version](https://img.shields.io/badge/version-1.0.1-blue)
+![License](https://img.shields.io/badge/license-MIT-green)
+
+## Key Features
+
+- 🎯 **New: Split Selectors Mode** - Optional splitting of combined CSS selectors
+- 🔄 Convert CSS files/URLs to PHP arrays
+- 📱 Handle media queries & pseudo-classes
+- 🛠️ Auto-fix PHP syntax issues
+- 📊 Detailed statistics & reporting
+- 🔄 Advanced file merging with priority
+- 💾 Customizable output paths
+
+## Installation
+
+```bash
+# Clone repository
+git clone https://github.com/sakibweb/css2php
+
+# Navigate to directory
+cd css2php
+
+# Install dependencies
+pip install -r requirements.txt
+```
 
 **Convert CSS files/URLs to PHP arrays**
 
@@ -19,6 +47,7 @@
 *   **Merge Functionality:**  Capable of merging multiple PHP array files (generated by CSS2PHP) into a single, consolidated file, useful for combining styles from different sources.
 *   **Output Customization:** Allows setting a custom output directory and filename prefix for generated PHP files.
 *   **PHP Syntax Validation & Auto-Fix:**  Validates the generated PHP array for syntax errors and attempts to automatically fix common issues, ensuring code correctness.
+*   **Split Selectors Mode:** Option to split combined CSS selectors into individual keys in the PHP array. This might be useful in some scenarios but could lead to loss of CSS specificity. Controlled by the `--split-selectors` flag.
 *   **Statistics (Detailed):** Generates in-depth processing statistics, including class counts, compression ratio, media query and pseudo-class detection, and syntax validation status.
 *   **Tailwind CSS Compatibility:**  Handles common Tailwind CSS escape patterns in class names for cleaner PHP output.
 *   **Timeout Control:** Sets a timeout for fetching remote CSS files, preventing indefinite hangs.
@@ -85,6 +114,14 @@ css2php -m -md ./php_output -mn combined_styles
 
 This will merge all PHP files found in the `./php_output` directory and create a merged file named `combined_styles.php` in the `./output` directory.
 
+**Splitting CSS Selectors:**
+
+To split combined CSS selectors (like `.class1.class2`) into individual keys:
+
+```bash
+css2php styles.css --split-selectors
+```
+
 ## Command-Line Arguments
 
 Here is a list of all available command-line arguments, sorted alphabetically:
@@ -129,6 +166,10 @@ Here is a list of all available command-line arguments, sorted alphabetically:
     *   **Description:**  Instructs CSS2PHP to skip errors encountered during CSS fetching or parsing and continue processing other sources. Warnings will be printed for skipped errors.
     *   **Example:** `css2php styles.css -s`
 
+*   `--split-selectors`:
+    *   **Description:** Splits combined CSS selectors into individual keys in the PHP array.
+    *   **Example:** `css2php styles.css --split-selectors`
+
 *   `-sources` `[SOURCES ...]`:
     *   **Description:**  One or more CSS file paths or URLs to convert. This is the primary input for the tool.
     *   **Example:** `css2php styles.css https://example.com/theme.css`
@@ -176,6 +217,7 @@ CSS2PHP provides detailed reports and statistics for each conversion and merge o
     *   Skip errors (Yes/No)
     *   Timeout (seconds)
     *   Overwrite enabled (Yes/No)
+    *   Split Selectors (Yes/No)
 *   **File Structure Explanation:**  Describes the structure of the generated PHP array.
 
 **For merge operations, the report includes:**