orion-ecs / keen-eye / 20396713449

65%

push

github

Add KeenEyes.Particles high-performance particle system (Issues #422, #423)

Implements a complete particle system for visual effects (fire, smoke,
explosions, magic sparkles) with the following architecture:

**Core Design Decisions:**
- Particles are NOT entities - pooled data for performance (10K+ at 60fps)
- SOA memory layout - separate arrays for positions, velocities, colors, etc.
- Modifiers as components - VelocityOverLifetime, ColorOverLifetime, etc.
- Pre-sampled curves - 64-element LUTs for AOT-compatible evaluation

**Components:**
- ParticleEmitter - emission rate, burst mode, shape, texture, blend mode
- ParticleEmitterModifiers - gravity, drag, velocity/size/color/rotation curves

**Data Types:**
- ParticlePool - SOA arrays with free list for O(1) alloc/release
- EmissionShape - Point, Sphere, Cone, Box spawning patterns
- ParticleCurve - pre-sampled 64-element curves for smooth interpolation
- ParticleGradient - pre-sampled color gradients
- BlendMode - Transparent, Additive, Multiply, Premultiplied

**Systems:**
- ParticleSpawnSystem - continuous and burst emission with shape support
- ParticleUpdateSystem - aging, modifiers, movement, particle death
- ParticleRenderSystem - batched rendering grouped by blend mode

**Plugin:**
- ParticlesPlugin - IWorldPlugin with component subscriptions
- ParticleManager - central pool manager exposed as world extension
- ParticlesConfig - configurable limits (max particles, emitters, pool size)

**Sample Effects:**
- Fire, Smoke, Explosion, Magic Sparkles presets in ParticleEffects

**Test Coverage:**
- 265 tests with 97.9% line coverage
- All systems at 95%+ coverage (RenderSystem: 100%, UpdateSystem: 100%)
- Comprehensive edge case testing (lazy init, pool null checks, etc.)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2856 of 3947 branches covered (72.36%)

Branch coverage included in aggregate %.

917 of 926 new or added lines in 14 files covered. (99.03%)

16580 of 26581 relevant lines covered (62.38%)

0.89 hits per line