EDIT: BLAS build is now per-frame async

docs/SHADERS.md

@@ -23,9 +23,36 @@
     - `vec4 metal_rough_factors; // x = metallic, y = roughness`
     - `vec4 extra[14];            // extra[0].x = normalScale`
   - Material texture bindings (set=1):
-    - binding=1 `colorTex`, binding=2 `metalRoughTex`, binding=3 `normalMap`.
+    - binding=1 `colorTex`, binding=2 `metalRoughTex`, binding=3 `normalMap`, binding=4 `occlusionTex`, binding=5 `emissiveTex`.
 
 - Adding a pipeline (graphics)
   - Fill `GraphicsPipelineCreateInfo` with shader paths, descriptor set layouts, optional push constants, and a `configure(PipelineBuilder&)` callback to set topology, raster, depth/blend, and attachment formats.
   - Register with `PipelineManager::createGraphicsPipeline(name, info)`. Retrieve via `getGraphics` or `getMaterialPipeline`.
 
+Shader File Reference
+
+| File | Stage | Description |
+|------|-------|-------------|
+| `fullscreen.vert` | Vertex | Fullscreen triangle for post-process passes |
+| `mesh.vert` | Vertex | Standard mesh vertex transform |
+| `mesh.frag` | Fragment | Forward shading (deprecated, use gbuffer) |
+| `gbuffer.frag` | Fragment | G-Buffer output (position, normal, albedo, AO+emissive) |
+| `deferred_lighting.frag` | Fragment | Deferred lighting with RT shadows + IBL |
+| `deferred_lighting_nort.frag` | Fragment | Deferred lighting without RT |
+| `shadow.vert/.frag` | Vertex/Fragment | Shadow map generation |
+| `ssr.frag` | Fragment | Screen-space reflections (ray march) |
+| `ssr_rt.frag` | Fragment | SSR + RT fallback (ray query) |
+| `tonemap.frag` | Fragment | HDR→LDR tonemapping + bloom |
+| `fxaa.frag` | Fragment | Fast approximate anti-aliasing |
+| `sky.comp` | Compute | Procedural sky background |
+| `gradient_color.comp` | Compute | Gradient background |
+| `background_env.frag` | Fragment | Environment map background |
+
+GLSL Includes
+
+| File | Purpose |
+|------|---------|
+| `input_structures.glsl` | SceneData UBO, material bindings, light structs |
+| `lighting_common.glsl` | BRDF evaluation, point light helpers |
+| `ibl_common.glsl` | IBL split-sum, SH irradiance |
+