🚀 FConcat GUI Pro

A beautiful, professional VSCode extension that provides an intuitive graphical interface for the ultra-fast fconcat file concatenator.

✨ Features

• 🎨 Beautiful Modern UI - Clean, professional interface with VSCode theming
• 📁 Visual File Tree - Interactive file explorer with icons and file sizes
• ✅ Smart Selection - Left-click to include, right-click to exclude files
• 📊 Real-time Stats - Live count of included/excluded files
• ⚡ Live Preview - See the generated fconcat command as you work
• 🔧 Full Configuration - Support for all fconcat options
• 💾 File Size Display - Optional file size information
• 🎯 Pattern Support - Custom include/exclude patterns
• 📋 Multiple Formats - Text and JSON output support
• 🔗 Symlink Handling - Configurable symbolic link behavior
• 📊 Logging Levels - Adjustable verbosity from error to trace

📸 Interface Highlights

• Header: Beautiful gradient header with tool branding
• File Tree: Clean file explorer with hover effects and visual feedback
• Configuration Panel: Comprehensive options panel with all fconcat features
• Status Bar: Real-time status indicator for fconcat availability
• Legend: Clear visual guide for file selection
• Statistics: Live counters for included/excluded files
• Command Preview: Real-time generated command display

🎮 Usage

1. Open the GUI:

   • Right-click any folder in Explorer → "🚀 Open FConcat GUI"
   • Or use Command Palette → "FConcat: Open GUI"

2. Select Files:

   • Left Click: Include file/folder (green highlight)
   • Right Click: Exclude file/folder (red highlight with strikethrough)
   • Files show appropriate icons and optional sizes

3. Configure Options:

   • Set output file path (with file browser)
   • Choose binary file handling
   • Select output format (text/JSON)
   • Configure symbolic link behavior
   • Set logging level and verbosity
   • Add custom include/exclude patterns

4. Execute:

   • Click "⚡ Run FConcat Pro" to execute
   • Command runs in integrated terminal
   • Real-time status updates

🔧 Advanced Features

• Pattern Matching: Full support for wildcards (* and ?)
• Nested Selection: Directory selection includes/excludes all children
• Custom Patterns: Add your own include/exclude patterns
• Binary Handling: Skip, include, or show placeholders for binary files
• Symlink Options: Skip, follow, include, or show placeholders
• Format Options: Plain text or structured JSON output
• Logging Control: Error, warning, info, debug, or trace levels

📋 Requirements

• VSCode 1.74.0 or higher
• fconcat binary available in your system PATH

🗂️ File Type Icons

The interface shows appropriate icons for different file types:

• 📁 Directories
• 🐍 Python files
• ⚡ C/C++ files
• 📜 JavaScript/TypeScript
• 🌐 HTML files
• 🎨 CSS files
• 📋 JSON/Config files
• 🖼️ Images
• 📄 Generic files

🎯 Tips

• Use the refresh button (🔄) to reload the file tree
• Clear selection (❌) removes all includes/excludes
• The command preview updates in real-time
• Status indicator shows fconcat availability
• File sizes are shown when available
• Right-click context menu provides exclude option

🛠️ Development

Built with modern web technologies and VSCode extension API for optimal performance and user experience.