Blacksite/third_party/bevy_solari/BLACKSITE_PATCH.md

Blacksite Solari Patch Boundary

Base: bevy_solari 0.19.0.

Blacksite-owned changes are deliberately limited to the scene module and dependency manifest:

• extract either MeshMaterial3d<StandardMaterial> or MeshMaterial3d<SurfaceMaterial>;
• pack the Surface ABI v1 uniform lanes, UV transforms, and eight texture bindings into Solari's scene material buffer;
• rebuild the embedded scene shader library from the active, validated SurfaceEvaluatorRegistry;
• namespace evaluator/helper functions by stable shader ID and use the same evaluator for ray-hit shading and cutout candidate acceptance;
• build shared mesh BLAS geometry as non-opaque so per-instance cutout materials can reject hits;
• retain standard Bevy materials and reject blended material modes from the ray scene.

The game_hot bridge owns eligibility and diagnostics. Until an instance-owned post-morph/post-skin vertex buffer can feed a dynamic BLAS, it removes RaytracingMesh3d from skinned or morphed entities and reports them through deformed_meshes_excluded. Rigid animated descendants remain supported because their geometry is static and their current/previous transforms are already extracted.

When rebasing, compare upstream changes only in src/scene/ first. Preserve the evaluator-registry extraction, GPU/WGSL material layouts, non-opaque BLAS flag, and candidate traversal as one atomic unit; a layout mismatch can pass Rust compilation but corrupt GPU reads. Validate the generated WGSL with Naga and run cargo test -p game_hot --lib after every rebase.