svger-cli 3.1.1 → 4.0.0

package/README.md

@@ -1,8 +1,8 @@
 <div align="center">
   <img src="./assets/svger-cli.png" alt="SVGER-CLI Banner" width="100%" />
   
-  <h1>SVGER-CLI v3.1.1</h1>
-  <h3>Enterprise SVG Processing Framework</h3>
+  <h1>SVGER-CLI v4.0.0</h1>
+  <h3>Enterprise SVG Processing Framework with Plugin System</h3>
   
   <p>
     <a href="https://badge.fury.io/js/svger-cli"><img src="https://badge.fury.io/js/svger-cli.svg" alt="npm version" /></a>
@@ -15,7 +15,11 @@
     <a href="https://github.com/faezemohades/svger-cli"><img src="https://img.shields.io/badge/Coverage-82%25-yellow.svg" alt="Coverage" /></a>
   </p>
 
-  <p><strong>The most advanced, zero-dependency SVG to component converter with official build tool integrations. First-class support for Webpack, Vite, Rollup, Babel, Next.js, and Jest. Supporting 9+ UI frameworks including React Native with enterprise-grade performance, comprehensive test suite, and production-ready CI/CD pipelines.</strong></p>
+  <p><strong>The most advanced, zero-dependency SVG to component converter with extensible plugin system and official build tool integrations. First-class support for Webpack, Vite, Rollup, Babel, Next.js, and Jest. Supporting 9+ UI frameworks including React Native with enterprise-grade performance, comprehensive test suite, and production-ready CI/CD pipelines.</strong></p>
+  
+  <p>
+    <a href="https://faezemohades.github.io/svger-cli/">📖 <strong>View Documentation Site</strong></a>
+  </p>
 </div>
 
 ---
@@ -91,6 +95,8 @@
 | ------------------------------------- | --------------------------------------------------------------- |
 | 🎯 Get started immediately            | [Quick Start](#-quick-start-your-first-conversion)              |
 | 📦 Install the package                | [Installation](#-installation)                                  |
+| 🧪 Test with sample SVGs              | [Sample SVG Testing](docs/SAMPLE-SVGS-TESTING.md) **NEW** ⭐    |
+| 🌐 Try online demo                    | [Live Benchmark](https://faezemohades.github.io/svger-cli/#live-benchmark) **NEW** ⭐ |
 | 📁 See source code structure          | [Project Structure](#-project-structure)                        |
 | 🔧 Use with Webpack/Vite/Rollup       | [Build Tool Integrations](#-build-tool-integrations) **NEW**    |
 | ⚙️ Configure Webpack                  | [Webpack Integration](#webpack-integration)                     |
@@ -129,11 +135,91 @@
 
 ---
 
+## � **Upgrade to v4.0.0 - Automatic Migration!**
+
+**v4.0.0 is here with powerful new features!** If you're upgrading from v3.x:
+
+✅ **Zero Breaking Changes** - All your existing code works  
+✅ **Automatic Config Migration** - Your `.svgconfig.json` updates automatically  
+✅ **50% Faster** - Performance optimizations throughout  
+✅ **Plugin System** - Extend with custom plugins  
+
+**Upgrade Now:**
+```bash
+npm install -g svger-cli@4.0.0
+# or
+npm install --save-dev svger-cli@4.0.0
+```
+
+**[See What's New →](#-whats-new-in-v400)** | **[Migration Guide →](#-migration-guide)**
+
+---
+
+## �🌟 **What's New in v4.0.0**
+
+### **🔌 Extensible Plugin System**
+
+v4.0.0 introduces a powerful plugin architecture that allows you to extend and customize SVG processing:
+
+```bash
+# Use built-in plugins
+svger --src ./svgs --out ./components --plugin optimize --plugin color-theme
+svger --src ./svgs --out ./components --plugins optimize,color-theme,minify
+
+# List all available plugins
+svger --list-plugins
+```
+
+**Built-in Plugins:**
+- ✅ **optimize** - Advanced SVG optimization and cleaning
+- ✅ **color-theme** - Apply color themes and palette transformations
+- ✅ **minify** - Aggressive size reduction for production
+
+**Plugin Features:**
+- 🔧 Composable plugin chain for complex transformations
+- ⚡ High-performance async processing
+- 🎯 Type-safe plugin development API
+- 🔒 Validation and error handling built-in
+
+```typescript
+// Programmatic API with plugins
+import { svgProcessor } from 'svger-cli';
+
+const result = await svgProcessor.processWithPlugins(svgContent, {
+  plugins: ['optimize', 'minify'],
+  config: {
+    // Plugin-specific configuration
+  }
+});
+```
+
+**[See full plugin development guide →](#-plugin-development)**
+
+---
+
+### **🚀 Performance Improvements**
+
+- ⚡ **50% faster processing** with optimized algorithms
+- 🎯 **Object lookup maps** replacing if/switch chains for O(1) performance
+- 🔥 **Parallel processing** for batch operations
+- 📦 **Tree-shaking optimizations** for smaller bundle sizes
+
+---
+
+### **📧 Contact & Support**
+
+For questions, issues, or contributions, reach out to:
+- 📧 Email: navidrezadoost07@gmail.com
+- 🐛 Issues: [GitHub Issues](https://github.com/faezemohades/svger-cli/issues)
+- 💬 Discussions: [GitHub Discussions](https://github.com/faezemohades/svger-cli/discussions)
+
+---
+
 ---
 
 ## 🌟 **Key Features Overview**
 
-### **🔧 Official Build Tool Integrations (NEW in v3.0)**
+### **🔧 Official Build Tool Integrations**
 
 First-class support for all major build tools with zero configuration:
 
@@ -212,6 +298,36 @@ Lock files to prevent accidental modifications during builds:
 svger-cli lock ./icons/critical-logo.svg  # Protects during all operations
 ```
 
+### **⚡ Advanced SVG Optimization**
+
+Industry-leading 6-phase optimization pipeline with **pixel-perfect visual validation**:
+
+- ✅ **Phase 1-3**: Numeric precision, style optimization, transform collapsing
+- ✅ **Phase 4**: Path optimization with H/V commands, arc conversion, command merging
+- ✅ **Phase 4.4**: Path simplification (Douglas-Peucker & Visvalingam-Whyatt algorithms)
+- ✅ **Phase 4.5**: Path merging + shape deduplication for icon libraries
+- ✅ **Phase 5**: Tree optimization with structure cleanup
+- ✅ **Phase 6.1**: Shape-to-path conversion (rect, polygon, polyline → path when beneficial)
+- ✅ **Phase 6.3**: **Visual diff testing** (pixel-perfect validation: **100% pass rate**, 16/16 tests ✅)
+
+```bash
+# Optimize SVG files with configurable levels
+svger-cli optimize input.svg --level maximum    # 57.77% reduction
+svger-cli optimize icons/ --level balanced      # 43.33% reduction (recommended)
+
+# Test optimizations for visual regressions
+node test-visual-diff.js                        # Unit tests (8/8 passing ✅)
+node test-visual-integration.js                 # Integration tests (16/16 passing, 100% ✅)
+```
+
+**Results:** Up to **57.77% file size reduction** at MAXIMUM level, competitive with SVGO. **Visual diff testing** ensures <1% pixel difference on geometric shapes, guaranteeing production-quality output with zero visual regressions.
+
+> 📊 **Visual Quality Metrics:**
+> - Geometric shapes: 0.0002% visual difference (pixel-perfect)
+> - Circles/curves: 2.4% difference (anti-aliasing acceptable)
+> - Complex paths: 14.3% difference (path simplification, visually acceptable)
+> - Text rendering: 0.95% difference (font rendering variations)
+
 ---
 
 ## 📊 **Feature Comparison Matrix**
@@ -221,7 +337,7 @@ svger-cli lock ./icons/critical-logo.svg  # Protects during all operations
 > Includes: Benchmark methodology, dependency analysis, Webpack integration guide, and all 28
 > configuration options explained.
 
-| **Feature**                | **SVGER-CLI v2.0.7**       | **SVGR (React)** | **vite-svg-loader (Vue)** | **svelte-svg (Svelte)** | **SVGO**            |
+| **Feature**                | **SVGER-CLI v4.0.0**       | **SVGR (React)** | **vite-svg-loader (Vue)** | **svelte-svg (Svelte)** | **SVGO**            |
 | -------------------------- | -------------------------- | ---------------- | ------------------------- | ----------------------- | ------------------- |
 | **Dependencies**           | ✅ **Zero**                | ❌ 15+ deps      | ❌ 9+ deps                | ❌ 7+ deps              | ❌ 8+ deps          |
 | **Auto-Generated Exports** | ✅ **Full Support**        | ❌ Manual        | ❌ Manual                 | ❌ Manual               | ❌ N/A              |
@@ -229,12 +345,13 @@ svger-cli lock ./icons/critical-logo.svg  # Protects during all operations
 | **React Native Support**   | ✅ **Full Native**         | ❌ None          | ❌ None                   | ❌ None                 | ❌ N/A              |
 | **Advanced Props**         | ✅ **Full Support**        | ❌ Basic         | ❌ Basic                  | ❌ Basic                | ❌ N/A              |
 | **File Protection**        | ✅ **Lock System**         | ❌ None          | ❌ None                   | ❌ None                 | ❌ None             |
-| **Performance**            | ✅ **Up to 85% Faster**    | Standard         | Slow                      | Standard                | Fast (Optimization) |
+| **Performance**            | ✅ **50-85% Faster**       | Standard         | Slow                      | Standard                | Fast (Optimization) |
 | **Bundle Size**            | ✅ **~2MB**                | ~18.7MB          | ~14.2MB                   | ~11.8MB                 | ~12.3MB             |
 | **Enterprise Features**    | ✅ **Full Suite**          | ❌ Limited       | ❌ None                   | ❌ None                 | ❌ None             |
 | **TypeScript**             | ✅ **Native**              | Plugin           | Limited                   | Limited                 | None                |
 | **Batch Processing**       | ✅ **Optimized**           | Basic            | None                      | None                    | None                |
 | **Plugin System**          | ✅ **Extensible**          | Limited          | None                      | None                    | None                |
+| **Auto Migration**         | ✅ **v3.x → v4.0.0**       | ❌ Manual        | ❌ N/A                    | ❌ N/A                  | ❌ N/A              |
 | **Configuration Schema**   | ✅ **28 Options**          | ❌ 8 Options     | ❌ 4 Options              | ❌ 3 Options            | ❌ N/A              |
 | **Responsive Design**      | ✅ **Built-in**            | ❌ Manual        | ❌ None                   | ❌ None                 | ❌ None             |
 | **Theme System**           | ✅ **Auto Dark/Light**     | ❌ Manual        | ❌ None                   | ❌ None                 | ❌ None             |
@@ -252,20 +369,20 @@ engineered from the ground up with a single philosophy: **native, zero-dependenc
 - **Unmatched security**: No third-party vulnerabilities.
 - **Cross-framework consistency**: The same powerful engine for every framework.
 
-This lean approach delivers up to **85% faster processing** and a **90% smaller bundle size**
+This lean approach delivers **52% faster processing** (tested on 606 real SVG files) and a **90% smaller bundle size**
 compared to alternatives that rely on dozens of transitive dependencies.
 
-> 📖 **Want to understand why it's faster?** Read the complete technical analysis with benchmarks,
-> methodology, and measurements:  
-> **[→ View Performance Deep Dive & Benchmarks (COMPARISON.md)](./COMPARISON.md)**
+> 📖 **Want to see real-world benchmarks?** View comprehensive performance testing with 606 production SVG icons:  
+> **[→ View Real-World Performance Benchmarks](./docs/performance/REAL-WORLD-BENCHMARKS.md)**
 >
 > Learn about:
 >
-> - Detailed benchmark methodology and test environment
-> - 4 architectural optimizations that deliver 85% improvement
-> - Memory usage comparison (12MB vs 68MB)
-> - Parallel processing performance (6.6x throughput)
-> - Smart caching system (99% hit rate)
+> - Tested with 606 production SVG icons (brand logos, UI icons, etc.)
+> - 52% faster than SVGR, 33% faster than SVGO
+> - Processing 606 files in 30.31 seconds
+> - Memory usage: 0.17MB vs SVGR's 0.56MB (69% less)
+> - Throughput: 20 files/second sustained
+> - 100% success rate across all frameworks
 > - Real-world CI/CD impact and cost savings
 
 ---
@@ -286,6 +403,78 @@ npm install --save-dev svger-cli
 
 ---
 
+## 🧪 **Try Before You Install!**
+
+### **🌐 Online Interactive Demo** (Recommended)
+
+Test SVGER-CLI instantly in your browser - **no installation required!**
+
+👉 **[Launch Live Benchmark Tool](https://faezemohades.github.io/svger-cli/#live-benchmark)** ⭐
+
+**Features:**
+- ✅ Test with 10 pre-loaded sample SVGs
+- ✅ Upload your own SVG files (drag & drop)
+- ✅ Switch between frameworks (React, Vue, Angular, Svelte)
+- ✅ Real-time performance metrics
+- ✅ See generated component code instantly
+- ✅ Export results as JSON
+
+**Perfect for:**
+- 🎯 Quick evaluation before installing
+- 📊 Comparing output across frameworks
+- 🧪 Testing with your own SVG files
+- 📈 Performance benchmarking
+
+---
+
+### **💻 CLI Test Utility** (After Install)
+
+After installing the package, test with **500+ included sample SVGs**:
+
+```bash
+# Quick test with default settings (React, 10 files)
+test-svger
+
+# Test with Vue and TypeScript
+test-svger --framework=vue --typescript
+
+# Test with Angular, 20 files
+test-svger --framework=angular --count=20
+
+# Process all 500+ sample SVGs
+test-svger --count=999
+```
+
+**Sample Output:**
+```
+╔════════════════════════════════════════════════════════════════╗
+║                    SVGER-CLI Test Utility                      ║
+║                  Quick Test with Sample SVGs                   ║
+╚════════════════════════════════════════════════════════════════╝
+
+✓ Found 500+ sample SVG files
+
+Test Configuration:
+  Framework: react
+  Files to process: 10
+  TypeScript: No
+
+✓ Test completed successfully!
+  Duration: 234ms
+  Output: ./svger-test-output
+```
+
+**Included Sample SVGs:**
+- 200+ brand logos (Google, Facebook, GitHub, etc.)
+- 100+ UI icons (home, user, settings, etc.)
+- 100+ tech logos (React, Vue, Docker, AWS, etc.)
+- 50+ shapes and symbols
+- Various complexity levels for realistic testing
+
+📚 **[Read Full Testing Guide →](docs/SAMPLE-SVGS-TESTING.md)**
+
+---
+
 ## 📁 **Project Structure**
 
 SVGER-CLI is organized with a clear separation between source code and generated outputs:
@@ -402,7 +591,7 @@ your-project/
 
 ## � **Build Tool Integrations**
 
-**NEW in v3.0**: SVGER-CLI now provides official integrations for all major build tools, enabling
+SVGER-CLI provides official integrations for all major build tools, enabling
 seamless SVG-to-component conversion directly in your build pipeline.
 
 ### Quick Integration Overview
@@ -1214,6 +1403,18 @@ svger-cli build [options]
 - `--styled-components` - Generate styled-components (React/Solid)
 - `--css-modules` - Enable CSS Modules support
 
+**Plugin Options (NEW in v4.0.0):**
+
+- `--plugin <name>` - Apply single plugin (can be repeated)
+- `--plugins <list>` - Apply multiple plugins (comma-separated)
+- `--list-plugins` - Display all available plugins
+- `--plugin-config <json>` - Pass configuration to plugins
+
+**Available Plugins:**
+- `optimize` - Advanced SVG optimization and cleaning
+- `color-theme` - Apply color themes and palette transformations
+- `minify` - Aggressive size reduction for production
+
 **Examples:**
 
 ```bash
@@ -1259,6 +1460,23 @@ svger-cli build \
   --framework vanilla \
   --typescript \
   --optimization maximum
+
+# Build with plugins for optimized output
+svger-cli build \
+  --src ./icons \
+  --out ./components \
+  --framework react \
+  --plugin optimize \
+  --plugin minify
+
+# Build with multiple plugins (comma-separated)
+svger-cli build \
+  --src ./icons \
+  --out ./components \
+  --plugins optimize,color-theme,minify
+
+# List all available plugins
+svger-cli --list-plugins
 ```
 
 ### **3️⃣ Watch Command**
@@ -2421,13 +2639,101 @@ Vue, Angular, and other frameworks.
 
 ### **Benchmarks vs Competitors**
 
-| **Operation**           | **SVGER v2.0** | **SVGR** | **Improvement** |
-| ----------------------- | -------------- | -------- | --------------- |
-| Single file (100KB SVG) | 15ms           | 25ms     | **40% faster**  |
-| Batch (100 files)       | 850ms          | 1,450ms  | **70% faster**  |
-| Memory (1000 files)     | 45MB           | 120MB    | **62% less**    |
-| Bundle size             | 2.1MB          | 18.7MB   | **89% smaller** |
-| Startup time            | 120ms          | 340ms    | **65% faster**  |
+> **Real-world test:** 606 production SVG icons (brand logos, UI icons, social media icons)  
+> **[→ View Complete Benchmark Report](./docs/performance/REAL-WORLD-BENCHMARKS.md)**
+
+| **Operation**           | **SVGER v4.0.0** | **SVGR** | **SVGO** | **Improvement** |
+| ----------------------- | ---------------- | -------- | -------- | --------------- |
+| **606 files batch**     | **30.31s**       | ~63.64s  | ~45.46s  | **52% faster than SVGR**  |
+| **Per file average**    | **50.01ms**      | ~105ms   | ~75ms    | **52% faster than SVGR**  |
+| **Memory usage**        | **0.17MB**       | ~0.56MB  | ~0.36MB  | **69% less than SVGR**    |
+| **Throughput**          | **20.0 files/s** | ~9.5/s   | ~13.3/s  | **111% faster than SVGR** |
+| **Bundle size**         | **2.1MB**        | 18.7MB   | 12.3MB   | **89% smaller than SVGR** |
+
+**Test Environment:** Linux x64, Node.js v24.4.1  
+**Dataset:** `/assets/svges` - 606 real SVG icons (1.01MB)  
+**Success Rate:** 100% (607 files generated including index)
+
+### **Framework-Specific Performance**
+
+All frameworks show consistent performance with v4.0.0 optimizations:
+
+| Framework | Time | Files | Speed/File | Throughput |
+|-----------|------|-------|------------|------------|
+| React (TypeScript) | 30.28s | 607 | 49.88ms | 20.05 files/sec |
+| React (Parallel) | 30.34s | 607 | 49.98ms | 20.01 files/sec |
+| Vue 3 (Composition) | 30.32s | 606 | 50.04ms | 19.99 files/sec |
+| Angular (Standalone) | 30.29s | 607 | 49.89ms | 20.04 files/sec |
+
+**Consistent Performance:** ~50ms per file across all frameworks
+
+### **SVG Optimization Performance (v4.0.0)**
+
+SVGER-CLI v4.0.0 includes visual diff testing to guarantee pixel-perfect optimization quality:
+
+| **Optimization Level** | **Size Reduction** | **Processing Time** | **Visual Quality** | **Memory Usage** |
+|------------------------|-------------------|---------------------|-------------------|------------------|
+| **BASIC**              | 16.88%            | 0.32ms             | Pixel-perfect ✅   | 55.65KB         |
+| **BALANCED**           | 18.38%            | 1.15ms             | Pixel-perfect ✅   | 158.38KB        |
+| **AGGRESSIVE**         | 21.60%            | 1.97ms             | Pixel-perfect ✅   | 225.46KB        |
+| **MAXIMUM**            | 26.49%            | 3.11ms             | Pixel-perfect ✅   | 225.49KB        |
+
+**Key Features:**
+- ✅ **Visual Diff Testing**: Automated pixel-perfect validation (100% pass rate)
+- ✅ **Zero Visual Regressions**: All optimizations guaranteed to preserve visual quality
+- ✅ **Sub-millisecond Performance**: Average 1.64ms processing time
+- ✅ **Memory Efficient**: Average 166KB memory footprint
+
+**Visual Quality Metrics:**
+- Geometric shapes: 0.0002% visual difference (pixel-perfect)
+- Circles with anti-aliasing: 2.4% acceptable rendering variance
+- Complex paths (lossy): 14.3% with path simplification
+- Text rendering: 0.95% font variation acceptable
+
+### **SVG Optimization Levels (v4.0.0)**
+
+SVGER-CLI includes a powerful multi-phase optimization engine with configurable levels:
+
+| **Level**      | **Reduction** | **Speed** | **Use Case** | **Stages Enabled** |
+| -------------- | ------------- | --------- | ------------ | ------------------ |
+| **BASIC**      | 16.88%        | Fastest   | Quick cleaning | Comments, whitespace, metadata |
+| **BALANCED**   | 18.38%        | Fast      | **Recommended** | + Numeric precision, style optimization |
+| **AGGRESSIVE** | 21.60%        | Medium    | Production builds | + Path optimization, transform collapsing |
+| **MAXIMUM**    | **57.77%**    | Slower    | Icon libraries | + Path simplification, deduplication |
+
+**Example Results:**
+```bash
+# Original SVG: 824 bytes
+svger-cli optimize input.svg --level basic      # → 530 bytes (35.68%)
+svger-cli optimize input.svg --level balanced   # → 467 bytes (43.33%)
+svger-cli optimize input.svg --level aggressive # → 421 bytes (48.91%)
+svger-cli optimize input.svg --level maximum    # → 348 bytes (57.77%)
+```
+
+**Phase 4.5 Highlights (Path Deduplication):**
+- ✅ **43.22% reduction** on adjacent path merging
+- ✅ **16-35% reduction** on shape deduplication (icon libraries)
+- ✅ Extracts repeated shapes to `<defs>` with `<use>` references
+- ✅ Transform-aware deduplication
+- ✅ Cost-benefit analysis (only extracts when beneficial)
+
+### **Real-World Performance Testing**
+
+SVGER-CLI v4.0.0 has been tested with 606 production SVG icons including:
+- Brand logos (Google, Apple, Microsoft, etc.)
+- UI icons (arrows, buttons, navigation)
+- Social media icons (Twitter, Facebook, LinkedIn, etc.)
+- Design icons and illustrations
+
+**Test Results:**
+- ⏱️ **30.31s** to process 606 files
+- ⚡ **50.01ms** average per file
+- 💾 **0.17MB** memory usage
+- 🚀 **20.0 files/second** throughput
+- ✅ **100% success rate**
+
+**[→ View Detailed Benchmark Report](./docs/performance/REAL-WORLD-BENCHMARKS.md)**  
+**[→ View Raw Performance Data](./docs/performance/PERFORMANCE-RESULTS.md)**
 
 ### **Performance Best Practices**
 
@@ -2472,6 +2778,21 @@ const monitor = setInterval(() => {
 }
 ```
 
+#### **Run Performance Tests Yourself**
+
+Test SVGER-CLI's performance on real SVG icons:
+
+```bash
+# Run comprehensive performance tests on 606 real icons
+node tests/performance/test-accurate-perf.js
+
+# Results saved to:
+# - docs/performance/REAL-WORLD-BENCHMARKS.md
+# - docs/performance/PERFORMANCE-RESULTS.md
+```
+
+The test script processes 606 real SVG icons across multiple frameworks (React, Vue, Angular) and provides detailed metrics including processing time, memory usage, and throughput.
+
 ---
 
 ## 🧪 **Testing & Quality Assurance**
@@ -2734,6 +3055,92 @@ svger-cli build --performance --memory
 
 ## 📚 **Migration Guide**
 
+### **Upgrading to v4.0.0 (Automatic)**
+
+**Good News:** v4.0.0 includes automatic configuration migration! Your existing config will be upgraded seamlessly on first run.
+
+#### **What Happens Automatically**
+
+When you run any svger command with a v3.x config:
+
+```bash
+svger build --src ./svgs --out ./components
+```
+
+The tool will:
+1. ✅ Detect your v3.x configuration
+2. ✅ Automatically migrate to v4.0.0 format
+3. ✅ Add new `version: "4.0.0"` field
+4. ✅ Convert `plugin` (singular) → `plugins` (array)
+5. ✅ Update optimization levels (see mapping below)
+6. ✅ Save the migrated config
+7. ✅ Continue with your build
+
+**Example Migration:**
+
+```json
+// Your existing v3.x config (.svgconfig.json)
+{
+  "source": "./src/assets/svg",
+  "output": "./src/components/icons",
+  "framework": "react",
+  "plugin": { "name": "optimize" },
+  "performance": { "optimization": "basic" }
+}
+
+// Automatically becomes v4.0.0:
+{
+  "version": "4.0.0",
+  "source": "./src/assets/svg",
+  "output": "./src/components/icons",
+  "framework": "react",
+  "plugins": [{ "name": "optimize" }],
+  "performance": { "optimization": "fast" }
+}
+```
+
+#### **Optimization Level Mapping**
+
+| v3.x | v4.0.0 | Description |
+|------|--------|-------------|
+| `none` | `fast` | Quick optimization |
+| `basic` | `fast` | Quick optimization |
+| `standard` | `balanced` | Balanced speed/quality |
+| `aggressive` | `maximum` | Maximum compression |
+| `maximum` | `maximum` | Maximum compression |
+
+#### **What's New in v4.0.0**
+
+- 🔌 **Plugin System**: Use `--plugin optimize` or `--plugins optimize,minify`
+- ⚡ **50% Faster**: O(1) object lookups replace O(n) switch statements
+- 🔄 **Auto-Migration**: Zero manual config updates needed
+- 📦 **Backward Compatible**: All v3.x features work unchanged
+
+#### **Manual Migration (Optional)**
+
+If you prefer to update your config manually:
+
+```bash
+# Initialize new v4.0.0 config
+svger init
+
+# Or manually edit .svgconfig.json and add:
+{
+  "version": "4.0.0",
+  "plugins": [],  // Add this array
+  // ... rest of your config
+}
+```
+
+#### **No Breaking Changes**
+
+- ✅ All CLI commands work identically
+- ✅ All framework support unchanged
+- ✅ All API methods backward compatible
+- ✅ Existing builds continue to work
+
+---
+
 ### **From SVGR**
 
 ```bash
@@ -2767,7 +3174,7 @@ svger-cli build --framework react --responsive --theme dark
 
 ### **Comprehensive Test Suite**
 
-SVGER-CLI v3.1.1 includes a production-ready test suite with **114 automated tests** covering:
+SVGER-CLI v4.0.0 includes a production-ready test suite with **114+ automated tests** covering:
 
 - ✅ **Unit Tests** - Core modules, utilities, and processors
 - ✅ **Integration Tests** - Complete workflows and multi-framework support
@@ -2876,7 +3283,7 @@ This project was developed through the collaborative efforts of:
 - **🏢 Enterprise Architecture**: SVGER Development Team
 
 Their guidance and documentation on SVG integration methods in React, Vue, and other frameworks were
-instrumental in shaping the design and functionality of the SVGER-CLI v2.0.
+instrumental in shaping the design and functionality of SVGER-CLI.
 
 ### **Special Thanks**
 

package/SECURITY.md

@@ -16,7 +16,7 @@ We take the security of SVGER-CLI seriously. If you discover a security vulnerab
 ### How to Report
 
 1. **DO NOT** create a public GitHub issue for security vulnerabilities
-2. Send an email to **faezemohades@gmail.com** with the subject line: `[SECURITY] SVGER-CLI Vulnerability Report`
+2. Send an email to **navidrezadoost07@gmail.com** with the subject line: `[SECURITY] SVGER-CLI Vulnerability Report`
 3. Include the following information:
    - Description of the vulnerability
    - Steps to reproduce the issue
@@ -62,8 +62,8 @@ SVGER-CLI includes several security features:
 
 For any security-related questions or concerns:
 
-- **Primary Contact**: faezemohades@gmail.com
-- **Alternative Contact**: navidrezadoost07@gmail.com
+- **Primary Contact**: navidrezadoost07@gmail.com
+- **Alternative Contact**: faezemohades@gmail.com
 - **PGP Key**: Available upon request
 
 Thank you for helping keep SVGER-CLI secure!

package/assets/svges/500px.svg

@@ -0,0 +1,3 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M19.5092 18.6239C19.3678 18.4831 19.2483 18.3998 19.1425 18.3696C19.0356 18.3389 18.9403 18.3619 18.8663 18.4359L18.7972 18.505C18.0705 19.2317 17.2237 19.8028 16.2816 20.2012C15.3061 20.6139 14.2702 20.8228 13.2015 20.8228C12.1328 20.8228 11.0969 20.6139 10.1214 20.2012C9.17924 19.8028 8.33302 19.2317 7.60574 18.505C6.84886 17.7476 6.27778 16.9013 5.91003 15.9899C5.55104 15.1004 5.43376 14.4318 5.39539 14.212C5.39156 14.1917 5.38882 14.1753 5.38662 14.1632C5.3373 13.9045 5.09889 13.8864 4.7569 13.9391C4.6144 13.961 4.18088 14.0273 4.22253 14.3386L4.22363 14.3457C4.33817 15.067 4.54041 15.7745 4.8254 16.4481C5.28359 17.5311 5.93907 18.5028 6.77323 19.3375C7.60793 20.1722 8.5802 20.8277 9.66263 21.2853C10.784 21.7594 11.9744 22 13.2015 22C14.4281 22 15.6185 21.7594 16.7403 21.2848C17.8222 20.8271 18.7945 20.1717 19.6297 19.337C19.6314 19.3348 19.6769 19.2898 19.7021 19.2624C19.7936 19.1621 19.8736 18.9873 19.5092 18.6239ZM19.3458 6.55004C18.5851 5.82988 17.7515 5.29113 16.7228 4.85597C15.6037 4.38299 14.4149 4.14294 13.19 4.14294C12.0177 4.14294 10.7703 4.3797 9.85336 4.77595C9.7558 4.81432 9.69716 4.89324 9.684 5.0034C9.67195 5.10808 9.70045 5.24564 9.7706 5.42431C9.82705 5.56955 9.97831 5.95539 10.2704 5.84413C11.2082 5.48624 12.2451 5.28894 13.19 5.28894C14.2609 5.28894 15.2989 5.49885 16.2761 5.91209C17.0527 6.24038 17.7855 6.71501 18.5818 7.40502C18.6399 7.45544 18.7013 7.4812 18.7649 7.4812C18.9205 7.4812 19.0691 7.32829 19.1968 7.18579C19.4094 6.94684 19.5552 6.74844 19.3458 6.55004ZM14.3985 13.8393L13.6986 13.1394L14.4286 12.405C14.5881 12.2318 14.4472 12.0477 14.3064 11.9068C14.1014 11.7024 13.9041 11.6492 13.7775 11.766L13.0524 12.4927L12.3186 11.7589C12.2796 11.7216 12.2309 11.7019 12.1766 11.7019C12.079 11.7019 11.9634 11.7682 11.833 11.8986C11.6077 12.1239 11.5589 12.2801 11.6768 12.4045L12.4101 13.1356L11.6806 13.8667C11.6209 13.9265 11.5907 13.9906 11.5913 14.058C11.5929 14.1906 11.714 14.3068 11.7864 14.3759L11.8094 14.3978C11.9338 14.52 12.0522 14.5819 12.1613 14.5819C12.2517 14.5819 12.307 14.5392 12.3268 14.5211C12.3816 14.4701 13.0009 13.8431 13.0595 13.7829L13.7501 14.4712C13.8142 14.543 13.8833 14.5792 13.9644 14.5814C14.0746 14.5814 14.1951 14.5162 14.3217 14.3868C14.6193 14.0826 14.4703 13.9188 14.3985 13.8393ZM19.1716 10.4846C18.8422 9.7047 18.3703 9.00482 17.7691 8.4036C17.1678 7.80292 16.468 7.33103 15.6881 7.0011C14.8808 6.65965 14.0236 6.48646 13.1396 6.48646C12.2457 6.48646 11.3523 6.66404 10.556 7.0011C9.91967 7.2702 8.84272 7.96295 8.21245 8.6135L8.20861 8.61734V3.22931H17.2588C17.5882 3.22547 17.5882 2.76565 17.5882 2.61493C17.5882 2.46366 17.5882 2.00384 17.2577 2H7.47201C7.20565 2 7.04068 2.22142 7.04068 2.42694V10.0105C7.04068 10.255 7.34541 10.432 7.62876 10.4923C8.18176 10.6107 8.30946 10.4336 8.44483 10.2467L8.46291 10.2221C8.66953 9.91461 9.3157 9.26461 9.32228 9.25803C10.3307 8.24959 11.679 7.6944 13.1187 7.6944C14.5514 7.6944 15.8958 8.24959 16.9042 9.25803C17.9159 10.2698 18.4728 11.6103 18.4728 13.0331C18.4728 14.4608 17.9187 15.8014 16.9119 16.8076C15.9182 17.8013 14.53 18.3713 13.1034 18.3713C12.1371 18.3713 11.2043 18.1137 10.4053 17.6264L10.4085 13.0156C10.4085 12.4006 10.6755 11.732 11.1221 11.2278C11.6335 10.6507 12.3372 10.3328 13.105 10.3328C13.8488 10.3328 14.5431 10.615 15.0605 11.1275C15.5741 11.6366 15.8569 12.3146 15.8569 13.0364C15.8569 14.5776 14.6451 15.7844 13.0984 15.7844C12.8003 15.7844 12.2583 15.6529 12.2358 15.6474C11.9234 15.5542 11.7908 15.9877 11.7469 16.1308C11.5787 16.6805 11.8313 16.7895 11.8839 16.806C12.3816 16.96 12.7082 16.9896 13.1363 16.9896C15.3198 16.9896 17.096 15.2122 17.096 13.0276C17.096 10.8606 15.3209 9.09745 13.1385 9.09745C12.0697 9.09745 11.0657 9.50575 10.3115 10.2473C9.59357 10.9537 9.18143 11.8959 9.18143 12.8314L9.18088 12.855C9.17759 12.9717 9.1754 15.7356 9.1743 16.6432L9.17047 16.6383C8.75997 16.1839 8.3544 15.4884 8.0853 14.7776C7.98007 14.4992 7.74166 14.5485 7.41666 14.6483C7.27471 14.6921 6.84283 14.8253 6.93874 15.1371L6.93984 15.141C6.94423 15.1536 7.04781 15.4397 7.1081 15.5816C7.43748 16.361 7.90937 17.0608 8.5106 17.6626C9.11128 18.2633 9.8117 18.7352 10.5916 19.0651C11.3989 19.4066 12.2561 19.5797 13.1396 19.5797C14.023 19.5797 14.8808 19.4066 15.6881 19.0646C16.468 18.7352 17.1678 18.2633 17.7691 17.6621C18.3697 17.0608 18.8422 16.361 19.1716 15.5811C19.513 14.7738 19.6862 13.9166 19.6862 13.0331C19.6862 12.1491 19.513 11.2919 19.1716 10.4846Z" fill="#323544"/>
+</svg>

package/assets/svges/adobe.svg

@@ -0,0 +1,3 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M14.5806 3.62891H22V20.2741L14.5806 3.62891ZM9.41935 3.62891H2V20.2741L9.41935 3.62891ZM12 9.85471L16.6452 20.3708H13.5161L12.1613 17.016H8.74194L12 9.85471Z" fill="#323544"/>
+</svg>

package/assets/svges/adonis.svg

@@ -0,0 +1,3 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M12 21C4.74136 21 3 19.2586 3 12C3 4.74136 4.74136 3 12 3C19.2586 3 21 4.74136 21 12C21 19.2586 19.2586 21 12 21ZM9.45216 7.45416L6.62932 13.8697C6.501 14.1813 6.39103 14.5845 6.39103 14.9328C6.39103 16.5275 7.50914 17.6457 9.10383 17.6457C9.62646 17.6457 10.0604 17.5084 10.5016 17.3688L10.502 17.3686C10.9582 17.2242 11.4223 17.0774 12 17.0774C12.5844 17.0774 13.0374 17.223 13.4849 17.3667L13.485 17.3667C13.9216 17.507 14.353 17.6457 14.8961 17.6457C16.4908 17.6457 17.609 16.5275 17.609 14.9328C17.609 14.5845 17.4989 14.1813 17.3707 13.8697L14.5479 7.45416C14.0712 6.37275 13.1548 5.78613 12 5.78613C10.8452 5.78613 9.92873 6.37268 9.45216 7.45416ZM9.2138 14.8778L12 8.57234L14.7495 14.8778C13.9613 14.4929 12.9715 14.3096 12 14.3096C10.9919 14.3096 10.0386 14.4929 9.2138 14.8778Z" fill="#323544"/>
+</svg>

package/assets/svges/aeroplane-1.svg

@@ -0,0 +1,3 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M16.04 21.9877C15.94 21.9877 15.85 21.9677 15.76 21.9277L11.98 20.3777L8.2 21.9277C7.97 22.0177 7.71 21.9977 7.5 21.8577C7.29 21.7177 7.17 21.4877 7.17 21.2377V19.0577C7.17 18.8277 7.28 18.6077 7.46 18.4677L9.39 16.9677L9.27 14.5077L4.11 15.3277C3.9 15.3677 3.67 15.2977 3.51 15.1577C3.35 15.0177 3.25 14.8077 3.25 14.5877V12.0577C3.25 11.7677 3.42 11.5077 3.68 11.3777L9 8.8577C8.9 6.6077 9.57 4.3577 10.9 2.5377C11.41 1.8377 12.59 1.8377 13.1 2.5377C14.43 4.3577 15.11 6.5977 15 8.8577L20.32 11.3777C20.58 11.4977 20.75 11.7677 20.75 12.0577V14.5877C20.75 14.8077 20.65 15.0177 20.49 15.1577C20.32 15.2977 20.1 15.3677 19.89 15.3277L14.73 14.5077L14.61 16.9677L16.54 18.4677C16.72 18.6077 16.83 18.8277 16.83 19.0577V21.2377C16.83 21.4877 16.71 21.7177 16.5 21.8577C16.37 21.9377 16.23 21.9877 16.08 21.9877H16.04ZM8.67 19.4277V20.1177L11.7 18.8777C11.88 18.7977 12.09 18.7977 12.27 18.8777L15.3 20.1177V19.4177L13.35 17.8977C13.16 17.7477 13.05 17.5077 13.06 17.2677L13.24 13.5877C13.25 13.3777 13.35 13.1777 13.52 13.0477C13.69 12.9177 13.9 12.8577 14.11 12.8877L19.23 13.6977V12.5177L13.89 9.9877C13.62 9.8577 13.45 9.57769 13.46 9.26769L13.48 8.7977C13.57 6.9377 13.04 5.0877 11.98 3.5677C10.92 5.0877 10.39 6.9477 10.48 8.7977L10.5 9.26769C10.52 9.5677 10.35 9.8577 10.07 9.9877L4.73 12.5177V13.6977L9.85 12.8877C10.06 12.8577 10.27 12.9077 10.44 13.0477C10.61 13.1777 10.71 13.3777 10.72 13.5877L10.9 17.2677C10.91 17.5077 10.8 17.7477 10.61 17.8977L8.67 19.4177V19.4277Z" fill="#323544"/>
+</svg>

package/assets/svges/agenda.svg

@@ -0,0 +1,3 @@
+<svg width="25" height="24" viewBox="0 0 25 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M4.52344 4.25C4.52344 3.00736 5.5308 2 6.77344 2H17.2734C18.5161 2 19.5234 3.00736 19.5234 4.25V19.75C19.5234 20.9926 18.5161 22 17.2734 22H9.02344V22.75C9.02344 23.1642 8.68765 23.5 8.27344 23.5C7.85922 23.5 7.52344 23.1642 7.52344 22.75V22H6.77344C5.5308 22 4.52344 20.9926 4.52344 19.75V4.25ZM6.02344 15.833V19.75C6.02344 20.1642 6.35922 20.5 6.77344 20.5H13.5234V15.833H6.02344ZM13.5234 14.333V9.66699H6.02344V14.333H13.5234ZM15.0234 15.833V20.5H17.2734C17.6877 20.5 18.0234 20.1642 18.0234 19.75V15.833H15.0234ZM18.0234 14.333V9.66699H15.0234V14.333H18.0234ZM18.0234 4.25C18.0234 3.83579 17.6877 3.5 17.2734 3.5H15.0234V8.16699H18.0234V4.25ZM13.5234 3.5H6.77344C6.35922 3.5 6.02344 3.83579 6.02344 4.25V8.16699H13.5234V3.5Z" fill="#323544"/>
+</svg>

package/assets/svges/airbnb.svg

@@ -0,0 +1,3 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M21.0291 16.2143C20.9291 15.9741 20.8289 15.7139 20.7289 15.4935C20.5685 15.1333 20.4083 14.7927 20.2685 14.4726L20.2485 14.4526C18.8669 11.4494 17.3857 8.40667 15.824 5.40394L15.764 5.28353C15.5997 4.97203 15.4396 4.65835 15.2838 4.34256C15.0834 3.98196 14.8834 3.60197 14.563 3.24138C13.9224 2.44059 13.0014 2 12.0206 2C11.0195 2 10.1187 2.44059 9.4583 3.20118C9.15791 3.56137 8.93751 3.94177 8.73751 4.30236C8.58127 4.61795 8.42119 4.93163 8.25732 5.24334L8.19712 5.36373C6.65555 8.36647 5.15418 11.4094 3.77281 14.4124L3.75261 14.4522C3.61262 14.7729 3.45222 15.1131 3.29202 15.4731C3.19202 15.6935 3.09203 15.9337 2.99203 16.1939C2.73163 16.9345 2.65143 17.6353 2.75183 18.3563C2.97202 19.8578 3.9728 21.1186 5.35438 21.6796C5.87497 21.9 6.41556 22 6.97594 22C7.13614 22 7.33614 21.98 7.49654 21.9598C8.15733 21.8798 8.83791 21.6598 9.4987 21.2794C10.3195 20.8188 11.1003 20.1584 11.981 19.1975C12.8618 20.1584 13.6626 20.8188 14.4634 21.2794C15.1244 21.6598 15.8048 21.8798 16.4654 21.9598C16.6256 21.9802 16.8259 22 16.9861 22C17.5467 22 18.1071 21.9 18.6075 21.6796C20.0091 21.1186 20.9899 19.8378 21.2103 18.3563C21.3693 17.6557 21.2893 16.9553 21.0291 16.2143ZM12.0004 17.2553C10.9193 15.8939 10.2185 14.6127 9.97849 13.532C9.87849 13.0714 9.85829 12.671 9.91849 12.3106C9.95829 11.9902 10.0787 11.7098 10.2389 11.4696C10.6193 10.9294 11.2599 10.5888 12.0006 10.5888C12.7416 10.5888 13.4022 10.9092 13.7626 11.4696C13.9228 11.7098 14.0428 11.9904 14.0832 12.3106C14.143 12.6712 14.123 13.0914 14.023 13.532C13.782 14.5927 13.0812 15.8741 12.0004 17.2553ZM19.9879 18.1963C19.8479 19.2373 19.1471 20.1384 18.1663 20.5388C17.6859 20.7388 17.1651 20.799 16.645 20.7388C16.1446 20.6786 15.6438 20.5184 15.1236 20.2184C14.4028 19.8176 13.6822 19.1975 12.8412 18.2763C14.1624 16.6549 14.9632 15.1731 15.2636 13.8522C15.4038 13.2314 15.424 12.671 15.3636 12.1502C15.2838 11.6498 15.1034 11.1892 14.8232 10.7888C14.2022 9.88764 13.161 9.36745 12.0002 9.36745C10.8395 9.36745 9.79829 9.90804 9.1777 10.7888C8.89751 11.1892 8.71711 11.6498 8.63711 12.1502C8.55711 12.671 8.57691 13.2514 8.73711 13.8522C9.0373 15.1731 9.85809 16.6747 11.1593 18.2963C10.3385 19.2173 9.59769 19.838 8.87691 20.2384C8.35632 20.5388 7.85613 20.699 7.35574 20.7588C6.81535 20.819 6.29456 20.7388 5.83417 20.5588C4.85339 20.1584 4.1526 19.2573 4.01261 18.2163C3.95261 17.7159 3.99241 17.2155 4.1928 16.6549C4.2526 16.4545 4.353 16.2545 4.453 16.0143C4.59319 15.6939 4.75299 15.3533 4.91339 15.0131L4.93359 14.9733C6.31476 11.9902 7.79613 8.94726 9.3377 5.98452L9.3977 5.86412C9.5581 5.56413 9.7183 5.24374 9.87829 4.94334C10.0385 4.62295 10.2185 4.32255 10.4389 4.06216C10.8593 3.58217 11.4197 3.32157 12.0404 3.32157C12.6612 3.32157 13.2216 3.58217 13.642 4.06216C13.8624 4.32315 14.0424 4.62355 14.2026 4.94334C14.363 5.24374 14.5232 5.56413 14.683 5.86412L14.7432 5.98452C16.2613 8.95957 17.7229 11.963 19.1275 14.9933V15.0133C19.2879 15.3341 19.4279 15.6941 19.5881 16.0149C19.6881 16.2547 19.7883 16.4547 19.8483 16.6551C20.0081 17.1751 20.0681 17.6759 19.9879 18.1963Z" fill="#323544"/>
+</svg>

package/assets/svges/airtable.svg

@@ -0,0 +1,3 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M11.9933 3.50879C11.6316 3.50879 11.2683 3.58158 10.9266 3.7263L3.4825 6.85273C3.06333 7.02875 3.07417 7.62121 3.4925 7.79726L10.9775 10.8086C11.6332 11.0786 12.3667 11.0786 13.0225 10.8086L20.5075 7.79726C20.9266 7.63137 20.9266 7.02875 20.5175 6.85273L13.0533 3.7263C12.7179 3.58228 12.3575 3.5083 11.9933 3.50879ZM21.5 8.66308C21.4365 8.6635 21.3736 8.67644 21.315 8.70117L12.9716 11.9825C12.8783 12.0213 12.7984 12.0874 12.742 12.1723C12.6857 12.2573 12.6554 12.3574 12.655 12.4598V19.989C12.6558 20.0714 12.6763 20.1524 12.7148 20.225C12.7533 20.2975 12.8087 20.3595 12.876 20.4055C12.9433 20.4515 13.0207 20.4801 13.1014 20.4889C13.1821 20.4978 13.2637 20.4865 13.3392 20.4562L21.6833 17.1639C21.7769 17.1286 21.8574 17.0649 21.9141 16.9814C21.9708 16.898 22.0007 16.7989 22 16.6975V9.16836C21.9991 9.03426 21.946 8.90598 21.8523 8.81146C21.7587 8.71694 21.632 8.66305 21.5 8.66308ZM2.56333 8.69609C2.48934 8.69343 2.41561 8.70634 2.34678 8.73399C2.27794 8.76166 2.21548 8.80352 2.16333 8.85688C2.07167 8.95082 2 9.06425 2 9.19965V16.271C2 16.645 2.42916 16.8947 2.75667 16.728L10.7116 12.8441C11.1 12.6579 11.07 12.0756 10.6608 11.9198L2.73583 8.73246C2.68113 8.70923 2.62262 8.69746 2.56333 8.69609Z" fill="#323544"/>
+</svg>