feat(gpu): Implement recursive WGSL composition and modularize shaders (Task #50)

- Updated ShaderComposer to support recursive #include "snippet_name" with cycle detection.
- Extracted granular WGSL snippets: math/sdf_shapes, math/sdf_utils, render/shadows, render/scene_query, render/lighting_utils.
- Refactored Renderer3D to use #include in shaders, simplifying C++ dependency lists.
- Fixed WGPUShaderSourceWGSL usage on macOS to correctly handle composed shader strings.
- Added comprehensive unit tests for recursive composition in test_shader_composer.
- Verified system stability with test_3d_render and full test suite.
- Marked Task #50 as recurrent for future code hygiene.

1 files changed, 9 insertions, 0 deletions

diff --git a/assets/final/shaders/math/sdf_utils.wgsl b/assets/final/shaders/math/sdf_utils.wgsl
new file mode 100644
index 0000000..ce902bf
--- /dev/null
+++ b/assets/final/shaders/math/sdf_utils.wgsl
@@ -0,0 +1,9 @@
+fn get_normal_basic(p: vec3<f32>, obj_type: f32) -> vec3<f32> {
+    if (obj_type == 1.0) { return normalize(p); }
+    let e = vec2<f32>(0.001, 0.0);
+    return normalize(vec3<f32>(
+        get_dist(p + e.xyy, obj_type) - get_dist(p - e.xyy, obj_type),
+        get_dist(p + e.yxy, obj_type) - get_dist(p - e.yxy, obj_type),
+        get_dist(p + e.yyx, obj_type) - get_dist(p - e.yyx, obj_type)
+    ));
+}