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, 32 insertions, 0 deletions

diff --git a/src/effects/gaussian_blur_effect.h b/src/effects/gaussian_blur_effect.h
new file mode 100644
index 0000000..651c5c3
--- /dev/null
+++ b/src/effects/gaussian_blur_effect.h
@@ -0,0 +1,32 @@
+// This file is part of the 64k demo project.
+// It declares the GaussianBlurEffect.
+
+#pragma once
+
+#include "gpu/effect.h"
+#include "gpu/uniform_helper.h"
+
+// Parameters for GaussianBlurEffect (set at construction time)
+struct GaussianBlurParams {
+  float strength = 1.0f; // Default
+  float strength_audio = 0.5f; // how much to pulse with audio
+  float stretch = 1.f;   // y/x axis ratio
+  float _pad = 0.;
+};
+static_assert(sizeof(GaussianBlurParams) == 16,
+              "GaussianBlurParams must be 16 bytes for WGSL alignment");
+
+class GaussianBlurEffect : public PostProcessEffect {
+ public:
+  // Backward compatibility constructor (uses default params)
+  GaussianBlurEffect(const GpuContext& ctx);
+  // New parameterized constructor
+  GaussianBlurEffect(const GpuContext& ctx, const GaussianBlurParams& params);
+  void render(WGPURenderPassEncoder pass,
+              const CommonPostProcessUniforms& uniforms) override;
+  void update_bind_group(WGPUTextureView input_view) override;
+
+ private:
+  GaussianBlurParams params_;
+  UniformBuffer<GaussianBlurParams> params_buffer_;
+};