# Changelog

All notable changes to CompareKit will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [1.1.0] - 2025-11-15

### Added
- ✨ **Enhanced Glass Morphism Panels** - 6-layer depth system with gradient fills, colored glows, and randomized intensity (subtle/medium/high)
- ⚡ **VS Element Energy Effects** - 6 dynamic effect types randomly selected per generation:
  - Energy burst with radial rays
  - Lightning bolts connecting to logos
  - Particle burst with color variety
  - Energy lines with glow
  - Chromatic aberration for digital glitch effect
  - Combo effects for dramatic impact
- 🎨 **Multi-Layered Backgrounds** - 3-5 random layers per image for depth:
  - Atmospheric depth gradient
  - Mesh overlay texture
  - Light rays (god rays effect)
  - Floating particles with depth of field
- 💡 **Professional 3-Point Lighting System** - Randomized directional lighting:
  - Key light (main directional)
  - Fill light (opposite softer)
  - Rim lighting with color accents
  - Ambient occlusion for depth
- ✨ **Bokeh Effects** - 50-200 depth-based bokeh particles per image simulating depth of field
- 🎬 **Texture Overlay System** - Film realism effects with randomization:
  - Film grain (always applied)
  - Noise texture (70% chance)
  - Light leaks with color (50% chance)
  - Scan lines for tech feel (30% chance)
  - Subtle scratches (40% chance)
- 📦 **TextureManager Module** - New dedicated module for all texture effects

### Changed
- 🔄 Transformed image generation from flat PowerPoint-style to professional featured images
- 🎲 Enhanced randomization ensuring each generation looks unique
- 📈 Improved visual depth with layered rendering pipeline
- 🎯 Updated rendering pipeline: Background → Lighting → Glass Panels → Logos → VS Element → Vignette → Textures

### Technical
- Added `src/lib/textures.js` - New TextureManager class
- Enhanced `src/lib/canvas.js` - 5 new energy effect methods, improved hexToRgba helper
- Updated `src/generators/comparison.js` - Integrated all enhancement systems
- Enhanced `src/lib/backgrounds.js` - 4 new layer rendering methods
- Total additions: 675+ lines of new rendering code

### Performance
- Image generation time: Similar to v1.0.0 (~2-3 seconds)
- File sizes: Maintained at ~5KB per PNG image
- Memory usage: No significant increase

---

## [1.0.0] - 2025-11-15

### Added
- ✅ Initial release
- ✅ Comparison image generator with Canvas + Sharp
- ✅ 10 background variations (5 photorealistic, 5 abstract)
- ✅ 15 color schemes
- ✅ WebP export format
- ✅ Multi-image view (keep all generated images)
- ✅ Individual image deletion
- ✅ Automatic logo fetching and caching
- ✅ REST API with 8 endpoints
- ✅ Statistics tracking
- ✅ Generation history
- ✅ CloudLinux Passenger compatibility
- ✅ cPanel deployment support
- ✅ Responsive web interface
- ✅ Popular comparison presets

### Technical
- Node.js v18.20.8
- Express v4.18.2
- Canvas v2.11.2
- Sharp v0.33.0
- Deployed on cPanel with CloudLinux Passenger

### Documentation
- README.md
- BACKGROUND-CUSTOMIZATION.md
- Comprehensive deployment guides

---

## Version History

### How to Version

**Semantic Versioning (MAJOR.MINOR.PATCH):**
- **MAJOR** (1.x.x): Breaking changes, major new features
- **MINOR** (x.1.x): New features, backwards compatible
- **PATCH** (x.x.1): Bug fixes, minor improvements

**Examples:**
- `1.0.0` → `1.0.1`: Bug fix
- `1.0.0` → `1.1.0`: New feature added
- `1.0.0` → `2.0.0`: Breaking change

---

## Template for Future Releases

```markdown
## [X.X.X] - YYYY-MM-DD

### Added
- New features

### Changed
- Changes to existing functionality

### Deprecated
- Soon-to-be removed features

### Removed
- Removed features

### Fixed
- Bug fixes

### Security
- Security improvements
```

---

## Upcoming Features (Planned)

- [ ] Custom logo upload
- [ ] More background types
- [ ] Font customization
- [ ] Template system
- [ ] Batch download as ZIP
- [ ] API authentication
- [ ] User accounts
- [ ] Image gallery
