feat(gpu): add SDF camera infrastructure and effect base class

Add unified camera system for SDF raymarching effects:
- CameraParams struct (80 bytes): inv_view matrix + FOV/near/far/aspect
- SDFEffect base class: manages camera uniform, provides update_camera() helpers
- camera_common.wgsl: getCameraRay(), position/forward/up/right extractors
- SDFTestEffect: working example with orbiting camera + animated sphere

Refactor effect headers:
- Extract class definitions from demo_effects.h to individual .h files
- Update includes in .cc files to use specific headers
- Cleaner compilation dependencies, faster incremental builds

Documentation:
- Add SDF_EFFECT_GUIDE.md with complete workflow
- Update ARCHITECTURE.md, UNIFORM_BUFFER_GUIDELINES.md
- Update EFFECT_WORKFLOW.md, CONTRIBUTING.md

Tests: 34/34 passing, SDFTestEffect validated

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

1 files changed, 21 insertions, 0 deletions

diff --git a/src/effects/particle_spray_effect.h b/src/effects/particle_spray_effect.h
new file mode 100644
index 0000000..c83d691
--- /dev/null
+++ b/src/effects/particle_spray_effect.h
@@ -0,0 +1,21 @@
+// This file is part of the 64k demo project.
+// It declares the ParticleSprayEffect.
+
+#pragma once
+
+#include "gpu/effect.h"
+#include "effects/particle_defs.h"
+
+class ParticleSprayEffect : public Effect {
+ public:
+  ParticleSprayEffect(const GpuContext& ctx);
+  void compute(WGPUCommandEncoder encoder,
+               const CommonPostProcessUniforms& uniforms) override;
+  void render(WGPURenderPassEncoder pass,
+              const CommonPostProcessUniforms& uniforms) override;
+
+ private:
+  ComputePass compute_pass_;
+  RenderPass render_pass_;
+  GpuBuffer particles_buffer_;
+};