@forgeax/engine-runtime 0.1.2

package/src/__tests__/fog-producer-vfx-effect.ts

@@ -0,0 +1,272 @@
+import type { ParticleEffectAsset } from '@forgeax/engine-types';
+
+// Browser evidence consumes this build-time cooked program; Node Dawn recooks
+// the same source in the real fixture so compiler drift remains observable.
+export const FOG_VFX_EFFECT: ParticleEffectAsset = {
+  kind: 'particle-effect',
+  schemaVersion: 2,
+  programFingerprint: 'sha256:7aea3041966717f0072228d496da3a198af473f65e21096b084dad9c170a358d',
+  emitters: [
+    {
+      id: 'fog-producer',
+      capacity: 4,
+    },
+  ],
+  program: {
+    format: 'forgeax-vfx-program-2',
+    fingerprint: 'sha256:7aea3041966717f0072228d496da3a198af473f65e21096b084dad9c170a358d',
+    emitters: [
+      {
+        id: 'fog-producer',
+        module: 'fog-producer.vfx.wgsl',
+        capacity: 4,
+        backend: {
+          required: 'gpu',
+        },
+        space: 'local',
+        schedule: {
+          rate: 0,
+          bursts: [
+            {
+              time: 0,
+              count: 4,
+            },
+          ],
+        },
+        bounds: {
+          kind: 'sphere',
+          center: [0, 0, 0],
+          radius: 2,
+        },
+        renderers: [
+          {
+            kind: 'billboard',
+            material: '00000000-0000-7000-8000-00000000f001',
+            capacity: 4,
+            blend: 'alpha',
+          },
+          {
+            kind: 'mesh',
+            material: '00000000-0000-7000-8000-00000000f001',
+            mesh: '00000000-0000-7000-8000-00000000f002',
+          },
+          {
+            kind: 'ribbon',
+            material: '00000000-0000-7000-8000-00000000f001',
+            capacity: 4,
+            stripKey: 'alive-index',
+          },
+          {
+            kind: 'trail',
+            material: '00000000-0000-7000-8000-00000000f001',
+            capacity: 4,
+            historyLength: 4,
+          },
+          {
+            kind: 'beam',
+            material: '00000000-0000-7000-8000-00000000f001',
+            capacity: 4,
+            endpointField: 'velocity',
+          },
+        ],
+        channels: [],
+        events: [],
+        simulationWhenCulled: 'continue',
+        wgsl: 'struct VfxParticleX_naga_oil_mod_XMZXXEZ3FMF4F65TGPA5DU4DSMVWHKZDFX {\n    position: vec4<f32>,\n    velocity: vec4<f32>,\n    color: vec4<f32>,\n    size_rotation: vec4<f32>,\n    age: f32,\n    lifetime: f32,\n    alive: u32,\n    id: u32,\n}\n\nstruct VfxSpawnContextX_naga_oil_mod_XMZXXEZ3FMF4F65TGPA5DU4DSMVWHKZDFX {\n    delta: f32,\n    tick: u32,\n    seed: u32,\n    playCycle: u32,\n    particleId: u32,\n}\n\nstruct VfxUpdateContextX_naga_oil_mod_XMZXXEZ3FMF4F65TGPA5DU4DSMVWHKZDFX {\n    delta: f32,\n    tick: u32,\n    seed: u32,\n    playCycle: u32,\n    particleId: u32,\n}\n\nstruct ForgeaxVfxRuntime {\n    delta: f32,\n    tick: u32,\n    seed: u32,\n    playCycle: u32,\n    capacity: u32,\n    spawnCount: u32,\n    firstParticleId: u32,\n    rendererCount: u32,\n    viewProjection: mat4x4<f32>,\n    cameraRight: vec4<f32>,\n    cameraUp: vec4<f32>,\n    baseColor: vec4<f32>,\n    emissiveIntensity: vec4<f32>,\n    surface: vec4<f32>,\n    localToWorld: mat4x4<f32>,\n    topology: vec4<u32>,\n    billboard: vec4<f32>,\n    textureSheet: vec4<f32>,\n}\n\nstruct ForgeaxVfxCounters {\n    aliveCount: atomic<u32>,\n    droppedCount: atomic<u32>,\n    eventProduced: atomic<u32>,\n    eventConsumed: atomic<u32>,\n    eventDropped: atomic<u32>,\n    eventOverflow: atomic<u32>,\n}\n\nstruct ForgeaxVfxIndirect {\n    vertexOrIndexCount: u32,\n    instanceCount: u32,\n    firstVertexOrIndex: u32,\n    baseVertex: i32,\n    firstInstance: u32,\n}\n\nstruct ForgeaxVfxChannelInput {\n    position: vec4<f32>,\n    strength: f32,\n    sequence: u32,\n    channel: u32,\n    reserved: u32,\n}\n\nstruct ForgeaxVfxEvent {\n    position: vec4<f32>,\n    strength: f32,\n    sequence: u32,\n    channel: u32,\n    reserved: u32,\n}\n\n@group(0) @binding(0) \nvar<storage, read_write> forgeax_vfx_particles: array<VfxParticleX_naga_oil_mod_XMZXXEZ3FMF4F65TGPA5DU4DSMVWHKZDFX>;\n@group(0) @binding(1) \nvar<uniform> forgeax_vfx_runtime: ForgeaxVfxRuntime;\n@group(0) @binding(2) \nvar<storage, read_write> forgeax_vfx_alive_indices: array<u32>;\n@group(0) @binding(3) \nvar<storage, read_write> forgeax_vfx_counters: ForgeaxVfxCounters;\n@group(0) @binding(4) \nvar<storage, read_write> forgeax_vfx_indirect: array<ForgeaxVfxIndirect>;\n@group(0) @binding(5) \nvar<storage, read_write> forgeax_vfx_scratch: array<u32>;\n@group(0) @binding(6) \nvar<storage, read_write> forgeax_vfx_billboard_instances: array<f32>;\nvar<workgroup> forgeax_vfx_scan_scratch: array<u32, 256>;\n@group(0) @binding(8) \nvar<storage> forgeax_vfx_channel_inputs: array<ForgeaxVfxChannelInput>;\n@group(0) @binding(9) \nvar<storage, read_write> forgeax_vfx_events: array<ForgeaxVfxEvent>;\n\nfn vfx_integrateX_naga_oil_mod_XMZXXEZ3FMF4F65TGPA5DU4DSMVWHKZDFX(ctx: VfxUpdateContextX_naga_oil_mod_XMZXXEZ3FMF4F65TGPA5DU4DSMVWHKZDFX, particle_2: ptr<function, VfxParticleX_naga_oil_mod_XMZXXEZ3FMF4F65TGPA5DU4DSMVWHKZDFX>) {\n    let _e3 = (*particle_2).position;\n    let _e6 = (*particle_2).velocity;\n    let position_2 = (_e3.xyz + (_e6.xyz * ctx.delta));\n    let _e14 = (*particle_2).position.w;\n    (*particle_2).position = vec4<f32>(position_2, _e14);\n    return;\n}\n\nfn vfx_spawn(ctx_1: VfxSpawnContextX_naga_oil_mod_XMZXXEZ3FMF4F65TGPA5DU4DSMVWHKZDFX, particle_3: ptr<function, VfxParticleX_naga_oil_mod_XMZXXEZ3FMF4F65TGPA5DU4DSMVWHKZDFX>) {\n    let lane = f32((ctx_1.particleId & 3u));\n    (*particle_3).position = vec4<f32>(((lane - 1.5f) * 0.12f), 0f, 0f, 1f);\n    (*particle_3).velocity = vec4<f32>(0.8f, 0f, 0f, 0f);\n    (*particle_3).color = vec4<f32>(0.2f, 0.6f, 1f, 1f);\n    (*particle_3).size_rotation = vec4<f32>(0.22f, 0.22f, 0f, 0f);\n    (*particle_3).lifetime = 100f;\n    return;\n}\n\nfn vfx_update(ctx_2: VfxUpdateContextX_naga_oil_mod_XMZXXEZ3FMF4F65TGPA5DU4DSMVWHKZDFX, particle_4: ptr<function, VfxParticleX_naga_oil_mod_XMZXXEZ3FMF4F65TGPA5DU4DSMVWHKZDFX>) {\n    let _e3 = (*particle_4).velocity;\n    (*particle_4).velocity = vec4<f32>(_e3.xyz, 0f);\n    vfx_integrateX_naga_oil_mod_XMZXXEZ3FMF4F65TGPA5DU4DSMVWHKZDFX(ctx_2, particle_4);\n    (*particle_4).color = vec4<f32>(0.2f, 0.6f, 1f, 1f);\n    return;\n}\n\nfn forgeax_vfx_project(position: vec3<f32>) -> vec3<f32> {\n    let _e2 = forgeax_vfx_runtime.viewProjection;\n    let clip = (_e2 * vec4<f32>(position, 1f));\n    let inverseW = select(1f, (1f / clip.w), (abs(clip.w) > 0.000001f));\n    return (clip.xyz * inverseW);\n}\n\nfn forgeax_vfx_world_position(position_1: vec3<f32>) -> vec3<f32> {\n    let _e2 = forgeax_vfx_runtime.localToWorld;\n    return (_e2 * vec4<f32>(position_1, 1f)).xyz;\n}\n\n@compute @workgroup_size(256, 1, 1) \nfn forgeax_vfx_spawn_main(@builtin(global_invocation_id) invocation: vec3<u32>) {\n    var particle: VfxParticleX_naga_oil_mod_XMZXXEZ3FMF4F65TGPA5DU4DSMVWHKZDFX;\n\n    let index_1 = invocation.x;\n    let _e4 = forgeax_vfx_runtime.capacity;\n    if (index_1 >= _e4) {\n        return;\n    }\n    let _e8 = forgeax_vfx_scratch[index_1];\n    if (_e8 == 0u) {\n        let _e14 = forgeax_vfx_runtime.capacity;\n        let _e17 = forgeax_vfx_scratch[(_e14 + index_1)];\n        let deadRank = (index_1 - _e17);\n        let _e21 = forgeax_vfx_runtime.spawnCount;\n        if (deadRank < _e21) {\n            let _e39 = forgeax_vfx_runtime.firstParticleId;\n            particle = VfxParticleX_naga_oil_mod_XMZXXEZ3FMF4F65TGPA5DU4DSMVWHKZDFX(vec4<f32>(0f, 0f, 0f, 1f), vec4(0f), vec4(1f), vec4<f32>(1f, 1f, 0f, 0f), 0f, 1f, 1u, (_e39 + deadRank));\n            let _e48 = forgeax_vfx_runtime.delta;\n            let _e51 = forgeax_vfx_runtime.tick;\n            let _e54 = forgeax_vfx_runtime.seed;\n            let _e57 = forgeax_vfx_runtime.playCycle;\n            let _e59 = particle.id;\n            let ctx_3 = VfxSpawnContextX_naga_oil_mod_XMZXXEZ3FMF4F65TGPA5DU4DSMVWHKZDFX(_e48, _e51, _e54, _e57, _e59);\n            vfx_spawn(ctx_3, (&particle));\n            let _e63 = particle;\n            forgeax_vfx_particles[index_1] = _e63;\n            forgeax_vfx_scratch[index_1] = 1u;\n        }\n    }\n    if (index_1 == 0u) {\n        let _e71 = forgeax_vfx_runtime.capacity;\n        let _e74 = atomicLoad((&forgeax_vfx_counters.aliveCount));\n        let freeCount = (_e71 - _e74);\n        let _e80 = forgeax_vfx_runtime.spawnCount;\n        let _e83 = forgeax_vfx_runtime.spawnCount;\n        let _e86 = atomicAdd((&forgeax_vfx_counters.droppedCount), (_e80 - min(_e83, freeCount)));\n        return;\n    } else {\n        return;\n    }\n}\n\n@compute @workgroup_size(256, 1, 1) \nfn forgeax_vfx_update_main(@builtin(global_invocation_id) invocation_1: vec3<u32>) {\n    var particle_1: VfxParticleX_naga_oil_mod_XMZXXEZ3FMF4F65TGPA5DU4DSMVWHKZDFX;\n\n    let index_2 = invocation_1.x;\n    let _e4 = forgeax_vfx_runtime.capacity;\n    if (index_2 >= _e4) {\n        return;\n    }\n    let _e8 = forgeax_vfx_particles[index_2];\n    particle_1 = _e8;\n    let _e12 = forgeax_vfx_scratch[index_2];\n    if (_e12 == 0u) {\n        return;\n    }\n    let _e17 = forgeax_vfx_runtime.delta;\n    let _e20 = forgeax_vfx_runtime.tick;\n    let _e23 = forgeax_vfx_runtime.seed;\n    let _e26 = forgeax_vfx_runtime.playCycle;\n    let _e28 = particle_1.id;\n    let ctx_4 = VfxUpdateContextX_naga_oil_mod_XMZXXEZ3FMF4F65TGPA5DU4DSMVWHKZDFX(_e17, _e20, _e23, _e26, _e28);\n    vfx_update(ctx_4, (&particle_1));\n    let _e31 = particle_1.age;\n    let _e34 = forgeax_vfx_runtime.delta;\n    particle_1.age = (_e31 + _e34);\n    let _e37 = particle_1.age;\n    let _e39 = particle_1.lifetime;\n    if (_e37 >= _e39) {\n        particle_1.alive = 0u;\n    }\n    let _e46 = particle_1.alive;\n    forgeax_vfx_scratch[index_2] = select(0u, 1u, (_e46 != 0u));\n    let _e54 = particle_1;\n    forgeax_vfx_particles[index_2] = _e54;\n    return;\n}\n\n@compute @workgroup_size(256, 1, 1) \nfn forgeax_vfx_scan_blocks_main(@builtin(global_invocation_id) invocation_2: vec3<u32>, @builtin(local_invocation_id) local: vec3<u32>, @builtin(workgroup_id) group: vec3<u32>) {\n    var flag: u32 = 0u;\n    var offset: u32 = 1u;\n    var addend: u32;\n\n    let index_3 = invocation_2.x;\n    let lane_1 = local.x;\n    let _e8 = forgeax_vfx_runtime.capacity;\n    if (index_3 < _e8) {\n        let _e12 = forgeax_vfx_scratch[index_3];\n        flag = _e12;\n    }\n    let _e16 = flag;\n    forgeax_vfx_scan_scratch[lane_1] = _e16;\n    workgroupBarrier();\n    loop {\n        let _e18 = offset;\n        if (_e18 >= 256u) {\n            break;\n        }\n        addend = 0u;\n        let _e23 = offset;\n        if (lane_1 >= _e23) {\n            let _e26 = offset;\n            let _e29 = forgeax_vfx_scan_scratch[(lane_1 - _e26)];\n            addend = _e29;\n        }\n        workgroupBarrier();\n        let _e32 = forgeax_vfx_scan_scratch[lane_1];\n        let _e33 = addend;\n        forgeax_vfx_scan_scratch[lane_1] = (_e32 + _e33);\n        workgroupBarrier();\n        let _e35 = offset;\n        offset = (_e35 * 2u);\n    }\n    let _e40 = forgeax_vfx_runtime.capacity;\n    if (index_3 < _e40) {\n        let _e45 = forgeax_vfx_runtime.capacity;\n        let _e50 = forgeax_vfx_scan_scratch[lane_1];\n        let _e51 = flag;\n        forgeax_vfx_scratch[(_e45 + index_3)] = (_e50 - _e51);\n    }\n    if (lane_1 == 255u) {\n        let _e57 = forgeax_vfx_runtime.capacity;\n        let _e67 = forgeax_vfx_scan_scratch[lane_1];\n        forgeax_vfx_scratch[((_e57 * 2u) + group.x)] = _e67;\n        return;\n    } else {\n        return;\n    }\n}\n\n@compute @workgroup_size(1, 1, 1) \nfn forgeax_vfx_scan_block_offsets_main() {\n    var sum: u32 = 0u;\n    var block: u32 = 0u;\n\n    let _e3 = forgeax_vfx_runtime.capacity;\n    let blockCount = ((_e3 + 255u) / 256u);\n    loop {\n        let _e9 = block;\n        if (_e9 >= blockCount) {\n            break;\n        }\n        let _e13 = forgeax_vfx_runtime.capacity;\n        let _e16 = block;\n        let scratchIndex = ((_e13 * 2u) + _e16);\n        let blockSum = forgeax_vfx_scratch[scratchIndex];\n        let _e24 = sum;\n        forgeax_vfx_scratch[scratchIndex] = _e24;\n        let _e25 = sum;\n        sum = (_e25 + blockSum);\n        let _e27 = block;\n        block = (_e27 + 1u);\n    }\n    return;\n}\n\n@compute @workgroup_size(256, 1, 1) \nfn forgeax_vfx_add_offsets_main(@builtin(global_invocation_id) invocation_3: vec3<u32>, @builtin(workgroup_id) group_1: vec3<u32>) {\n    let _e4 = forgeax_vfx_runtime.capacity;\n    if (invocation_3.x >= _e4) {\n        return;\n    }\n    let _e9 = forgeax_vfx_runtime.capacity;\n    let _e13 = forgeax_vfx_scratch[(_e9 + invocation_3.x)];\n    let _e16 = forgeax_vfx_runtime.capacity;\n    let _e24 = forgeax_vfx_scratch[((_e16 * 2u) + group_1.x)];\n    forgeax_vfx_scratch[(_e9 + invocation_3.x)] = (_e13 + _e24);\n    return;\n}\n\n@compute @workgroup_size(256, 1, 1) \nfn forgeax_vfx_compact_main(@builtin(global_invocation_id) invocation_4: vec3<u32>) {\n    var local_1: bool;\n    var renderer: u32 = 0u;\n\n    let index_4 = invocation_4.x;\n    let _e5 = forgeax_vfx_runtime.capacity;\n    if (index_4 < _e5) {\n        let _e9 = forgeax_vfx_scratch[index_4];\n        local_1 = (_e9 != 0u);\n    } else {\n        local_1 = false;\n    }\n    let _e15 = local_1;\n    if _e15 {\n        let _e20 = forgeax_vfx_runtime.capacity;\n        let _e23 = forgeax_vfx_scratch[(_e20 + index_4)];\n        forgeax_vfx_alive_indices[_e23] = index_4;\n    }\n    if (index_4 == 0u) {\n        let _e29 = forgeax_vfx_runtime.capacity;\n        let last = (_e29 - 1u);\n        let _e35 = forgeax_vfx_runtime.capacity;\n        let _e38 = forgeax_vfx_scratch[(_e35 + last)];\n        let _e41 = forgeax_vfx_scratch[last];\n        let count = (_e38 + _e41);\n        atomicStore((&forgeax_vfx_counters.aliveCount), count);\n        loop {\n            let _e46 = renderer;\n            let _e49 = forgeax_vfx_runtime.rendererCount;\n            if (_e46 >= _e49) {\n                break;\n            }\n            let _e52 = renderer;\n            forgeax_vfx_indirect[_e52].instanceCount = count;\n            let _e55 = renderer;\n            renderer = (_e55 + 1u);\n        }\n        return;\n    } else {\n        return;\n    }\n}\n\n@compute @workgroup_size(1, 1, 1) \nfn forgeax_vfx_sort_main() {\n    var index: u32 = 1u;\n    var cursor: u32;\n\n    let _e4 = forgeax_vfx_runtime.topology.w;\n    if (_e4 != 2u) {\n        return;\n    }\n    let aliveCount = atomicLoad((&forgeax_vfx_counters.aliveCount));\n    loop {\n        let _e11 = index;\n        if (_e11 >= aliveCount) {\n            break;\n        }\n        let _e14 = index;\n        let candidate = forgeax_vfx_alive_indices[_e14];\n        let _e20 = forgeax_vfx_particles[candidate].position;\n        let _e22 = forgeax_vfx_world_position(_e20.xyz);\n        let _e23 = forgeax_vfx_project(_e22);\n        let candidateDepth = _e23.z;\n        let _e25 = index;\n        cursor = _e25;\n        loop {\n            let _e27 = cursor;\n            if (_e27 == 0u) {\n                break;\n            }\n            let _e30 = cursor;\n            let previous = forgeax_vfx_alive_indices[(_e30 - 1u)];\n            let _e39 = forgeax_vfx_particles[previous].position;\n            let _e41 = forgeax_vfx_world_position(_e39.xyz);\n            let _e42 = forgeax_vfx_project(_e41);\n            let previousDepth = _e42.z;\n            if (previousDepth >= candidateDepth) {\n                break;\n            }\n            let _e46 = cursor;\n            forgeax_vfx_alive_indices[_e46] = previous;\n            let _e48 = cursor;\n            cursor = (_e48 - 1u);\n        }\n        let _e52 = cursor;\n        forgeax_vfx_alive_indices[_e52] = candidate;\n        let _e54 = index;\n        index = (_e54 + 1u);\n    }\n    return;\n}\n\n@compute @workgroup_size(256, 1, 1) \nfn forgeax_vfx_billboard_main(@builtin(global_invocation_id) invocation_5: vec3<u32>) {\n    let rank = invocation_5.x;\n    let aliveCount_1 = atomicLoad((&forgeax_vfx_counters.aliveCount));\n    if (rank >= aliveCount_1) {\n        return;\n    }\n    let _e9 = forgeax_vfx_alive_indices[rank];\n    let particle_5 = forgeax_vfx_particles[_e9];\n    let _e14 = forgeax_vfx_world_position(particle_5.position.xyz);\n    let _e15 = forgeax_vfx_project(_e14);\n    let cosine = cos(particle_5.size_rotation.z);\n    let sine = sin(particle_5.size_rotation.z);\n    let _e24 = forgeax_vfx_runtime.cameraRight;\n    let _e29 = forgeax_vfx_runtime.cameraUp;\n    let rightAxis = ((_e24.xyz * cosine) + (_e29.xyz * sine));\n    let _e35 = forgeax_vfx_runtime.cameraUp;\n    let _e40 = forgeax_vfx_runtime.cameraRight;\n    let upAxis = ((_e35.xyz * cosine) - (_e40.xyz * sine));\n    let _e48 = forgeax_vfx_project((_e14 + (rightAxis * particle_5.size_rotation.x)));\n    let right = (_e48 - _e15);\n    let _e54 = forgeax_vfx_project((_e14 + (upAxis * particle_5.size_rotation.y)));\n    let up = (_e54 - _e15);\n    let base = (rank * 31u);\n    forgeax_vfx_billboard_instances[base] = _e15.x;\n    forgeax_vfx_billboard_instances[(base + 1u)] = _e15.y;\n    forgeax_vfx_billboard_instances[(base + 2u)] = _e15.z;\n    forgeax_vfx_billboard_instances[(base + 3u)] = right.x;\n    forgeax_vfx_billboard_instances[(base + 4u)] = right.y;\n    forgeax_vfx_billboard_instances[(base + 5u)] = up.x;\n    forgeax_vfx_billboard_instances[(base + 6u)] = up.y;\n    forgeax_vfx_billboard_instances[(base + 7u)] = particle_5.color.x;\n    forgeax_vfx_billboard_instances[(base + 8u)] = particle_5.color.y;\n    forgeax_vfx_billboard_instances[(base + 9u)] = particle_5.color.z;\n    forgeax_vfx_billboard_instances[(base + 10u)] = particle_5.color.w;\n    let _e122 = forgeax_vfx_runtime.baseColor.x;\n    forgeax_vfx_billboard_instances[(base + 11u)] = _e122;\n    let _e130 = forgeax_vfx_runtime.baseColor.y;\n    forgeax_vfx_billboard_instances[(base + 12u)] = _e130;\n    let _e138 = forgeax_vfx_runtime.baseColor.z;\n    forgeax_vfx_billboard_instances[(base + 13u)] = _e138;\n    let _e146 = forgeax_vfx_runtime.baseColor.w;\n    forgeax_vfx_billboard_instances[(base + 14u)] = _e146;\n    let _e154 = forgeax_vfx_runtime.emissiveIntensity.x;\n    forgeax_vfx_billboard_instances[(base + 15u)] = _e154;\n    let _e162 = forgeax_vfx_runtime.emissiveIntensity.y;\n    forgeax_vfx_billboard_instances[(base + 16u)] = _e162;\n    let _e170 = forgeax_vfx_runtime.emissiveIntensity.z;\n    forgeax_vfx_billboard_instances[(base + 17u)] = _e170;\n    let _e178 = forgeax_vfx_runtime.emissiveIntensity.w;\n    forgeax_vfx_billboard_instances[(base + 18u)] = _e178;\n    let _e186 = forgeax_vfx_runtime.surface.x;\n    forgeax_vfx_billboard_instances[(base + 19u)] = _e186;\n    let _e194 = forgeax_vfx_runtime.surface.y;\n    forgeax_vfx_billboard_instances[(base + 20u)] = _e194;\n    let _e202 = forgeax_vfx_runtime.surface.z;\n    forgeax_vfx_billboard_instances[(base + 21u)] = _e202;\n    let _e210 = forgeax_vfx_runtime.surface.w;\n    forgeax_vfx_billboard_instances[(base + 22u)] = _e210;\n    let _e214 = forgeax_vfx_runtime.textureSheet.w;\n    let frameCount = max(1f, _e214);\n    let _e225 = forgeax_vfx_runtime.textureSheet.z;\n    let frame = min((frameCount - 1f), floor((max(0f, particle_5.age) * _e225)));\n    let _e236 = forgeax_vfx_runtime.billboard.x;\n    forgeax_vfx_billboard_instances[(base + 23u)] = _e236;\n    let _e244 = forgeax_vfx_runtime.billboard.y;\n    forgeax_vfx_billboard_instances[(base + 24u)] = _e244;\n    forgeax_vfx_billboard_instances[(base + 25u)] = frame;\n    forgeax_vfx_billboard_instances[(base + 26u)] = frameCount;\n    let _e260 = forgeax_vfx_runtime.textureSheet.x;\n    forgeax_vfx_billboard_instances[(base + 27u)] = _e260;\n    let _e268 = forgeax_vfx_runtime.textureSheet.y;\n    forgeax_vfx_billboard_instances[(base + 28u)] = _e268;\n    let _e276 = forgeax_vfx_runtime.billboard.z;\n    forgeax_vfx_billboard_instances[(base + 29u)] = _e276;\n    let _e284 = forgeax_vfx_runtime.topology.w;\n    forgeax_vfx_billboard_instances[(base + 30u)] = f32(_e284);\n    return;\n}\n\n@compute @workgroup_size(256, 1, 1) \nfn forgeax_vfx_mesh_main(@builtin(global_invocation_id) invocation_6: vec3<u32>) {\n    let rank_1 = invocation_6.x;\n    let aliveCount_2 = atomicLoad((&forgeax_vfx_counters.aliveCount));\n    if (rank_1 >= aliveCount_2) {\n        return;\n    }\n    let _e9 = forgeax_vfx_alive_indices[rank_1];\n    let particle_6 = forgeax_vfx_particles[_e9];\n    let _e14 = forgeax_vfx_world_position(particle_6.position.xyz);\n    let _e15 = forgeax_vfx_project(_e14);\n    let scale = particle_6.size_rotation.x;\n    let cosine_1 = cos(particle_6.size_rotation.z);\n    let sine_1 = sin(particle_6.size_rotation.z);\n    let _e31 = forgeax_vfx_world_position((particle_6.position.xyz + vec3<f32>((cosine_1 * scale), (sine_1 * scale), 0f)));\n    let _e32 = forgeax_vfx_project(_e31);\n    let right_1 = (_e32 - _e15);\n    let _e42 = forgeax_vfx_world_position((particle_6.position.xyz + vec3<f32>((-(sine_1) * scale), (cosine_1 * scale), 0f)));\n    let _e43 = forgeax_vfx_project(_e42);\n    let up_1 = (_e43 - _e15);\n    let _e51 = forgeax_vfx_world_position((particle_6.position.xyz + vec3<f32>(0f, 0f, scale)));\n    let _e52 = forgeax_vfx_project(_e51);\n    let forward = (_e52 - _e15);\n    let base_1 = (rank_1 * 28u);\n    forgeax_vfx_billboard_instances[base_1] = _e15.x;\n    forgeax_vfx_billboard_instances[(base_1 + 1u)] = _e15.y;\n    forgeax_vfx_billboard_instances[(base_1 + 2u)] = _e15.z;\n    forgeax_vfx_billboard_instances[(base_1 + 3u)] = right_1.x;\n    forgeax_vfx_billboard_instances[(base_1 + 4u)] = right_1.y;\n    forgeax_vfx_billboard_instances[(base_1 + 5u)] = right_1.z;\n    forgeax_vfx_billboard_instances[(base_1 + 6u)] = up_1.x;\n    forgeax_vfx_billboard_instances[(base_1 + 7u)] = up_1.y;\n    forgeax_vfx_billboard_instances[(base_1 + 8u)] = up_1.z;\n    forgeax_vfx_billboard_instances[(base_1 + 9u)] = forward.x;\n    forgeax_vfx_billboard_instances[(base_1 + 10u)] = forward.y;\n    forgeax_vfx_billboard_instances[(base_1 + 11u)] = forward.z;\n    forgeax_vfx_billboard_instances[(base_1 + 12u)] = particle_6.color.x;\n    forgeax_vfx_billboard_instances[(base_1 + 13u)] = particle_6.color.y;\n    forgeax_vfx_billboard_instances[(base_1 + 14u)] = particle_6.color.z;\n    forgeax_vfx_billboard_instances[(base_1 + 15u)] = particle_6.color.w;\n    let _e145 = forgeax_vfx_runtime.baseColor.x;\n    forgeax_vfx_billboard_instances[(base_1 + 16u)] = _e145;\n    let _e153 = forgeax_vfx_runtime.baseColor.y;\n    forgeax_vfx_billboard_instances[(base_1 + 17u)] = _e153;\n    let _e161 = forgeax_vfx_runtime.baseColor.z;\n    forgeax_vfx_billboard_instances[(base_1 + 18u)] = _e161;\n    let _e169 = forgeax_vfx_runtime.baseColor.w;\n    forgeax_vfx_billboard_instances[(base_1 + 19u)] = _e169;\n    let _e177 = forgeax_vfx_runtime.emissiveIntensity.x;\n    forgeax_vfx_billboard_instances[(base_1 + 20u)] = _e177;\n    let _e185 = forgeax_vfx_runtime.emissiveIntensity.y;\n    forgeax_vfx_billboard_instances[(base_1 + 21u)] = _e185;\n    let _e193 = forgeax_vfx_runtime.emissiveIntensity.z;\n    forgeax_vfx_billboard_instances[(base_1 + 22u)] = _e193;\n    let _e201 = forgeax_vfx_runtime.emissiveIntensity.w;\n    forgeax_vfx_billboard_instances[(base_1 + 23u)] = _e201;\n    let _e209 = forgeax_vfx_runtime.surface.x;\n    forgeax_vfx_billboard_instances[(base_1 + 24u)] = _e209;\n    let _e217 = forgeax_vfx_runtime.surface.y;\n    forgeax_vfx_billboard_instances[(base_1 + 25u)] = _e217;\n    let _e225 = forgeax_vfx_runtime.surface.z;\n    forgeax_vfx_billboard_instances[(base_1 + 26u)] = _e225;\n    let _e233 = forgeax_vfx_runtime.surface.w;\n    forgeax_vfx_billboard_instances[(base_1 + 27u)] = _e233;\n    return;\n}\n\n@compute @workgroup_size(256, 1, 1) \nfn forgeax_vfx_ribbon_main(@builtin(global_invocation_id) invocation_7: vec3<u32>) {\n    let rank_2 = invocation_7.x;\n    let _e4 = atomicLoad((&forgeax_vfx_counters.aliveCount));\n    let _e8 = forgeax_vfx_runtime.topology.z;\n    let count_1 = min(_e4, _e8);\n    if (rank_2 == 0u) {\n        let _e16 = forgeax_vfx_runtime.topology.x;\n        forgeax_vfx_indirect[_e16].instanceCount = select(0u, (count_1 - 1u), (count_1 > 1u));\n    }\n    if ((rank_2 + 1u) >= count_1) {\n        return;\n    }\n    let _e31 = forgeax_vfx_alive_indices[rank_2];\n    let particle_7 = forgeax_vfx_particles[_e31];\n    let _e39 = forgeax_vfx_alive_indices[(rank_2 + 1u)];\n    let next = forgeax_vfx_particles[_e39];\n    let _e44 = forgeax_vfx_world_position(particle_7.position.xyz);\n    let _e45 = forgeax_vfx_project(_e44);\n    let _e48 = forgeax_vfx_world_position(next.position.xyz);\n    let _e49 = forgeax_vfx_project(_e48);\n    let base_2 = (rank_2 * 12u);\n    forgeax_vfx_billboard_instances[base_2] = _e45.x;\n    forgeax_vfx_billboard_instances[(base_2 + 1u)] = _e45.y;\n    forgeax_vfx_billboard_instances[(base_2 + 2u)] = _e45.z;\n    forgeax_vfx_billboard_instances[(base_2 + 3u)] = _e49.x;\n    forgeax_vfx_billboard_instances[(base_2 + 4u)] = _e49.y;\n    forgeax_vfx_billboard_instances[(base_2 + 5u)] = _e49.z;\n    forgeax_vfx_billboard_instances[(base_2 + 6u)] = particle_7.color.x;\n    forgeax_vfx_billboard_instances[(base_2 + 7u)] = particle_7.color.y;\n    forgeax_vfx_billboard_instances[(base_2 + 8u)] = particle_7.color.z;\n    forgeax_vfx_billboard_instances[(base_2 + 9u)] = particle_7.color.w;\n    let _e111 = forgeax_vfx_runtime.billboard.x;\n    forgeax_vfx_billboard_instances[(base_2 + 10u)] = _e111;\n    forgeax_vfx_billboard_instances[(base_2 + 11u)] = 0f;\n    return;\n}\n\n@compute @workgroup_size(256, 1, 1) \nfn forgeax_vfx_trail_history_main(@builtin(global_invocation_id) invocation_8: vec3<u32>) {\n    let rank_3 = invocation_8.x;\n    let _e4 = atomicLoad((&forgeax_vfx_counters.aliveCount));\n    let _e8 = forgeax_vfx_runtime.topology.z;\n    let count_2 = min(_e4, _e8);\n    if (rank_3 >= count_2) {\n        return;\n    }\n    let _e14 = forgeax_vfx_alive_indices[rank_3];\n    let particle_8 = forgeax_vfx_particles[_e14];\n    let _e21 = forgeax_vfx_runtime.topology.y;\n    let historyLength = max(2u, _e21);\n    let _e25 = forgeax_vfx_runtime.tick;\n    let slot = (_e25 % historyLength);\n    let historyTarget = (((rank_3 * historyLength) + slot) * 4u);\n    let _e33 = forgeax_vfx_world_position(particle_8.position.xyz);\n    forgeax_vfx_scratch[historyTarget] = bitcast<u32>(_e33.x);\n    forgeax_vfx_scratch[(historyTarget + 1u)] = bitcast<u32>(_e33.y);\n    forgeax_vfx_scratch[(historyTarget + 2u)] = bitcast<u32>(_e33.z);\n    forgeax_vfx_scratch[(historyTarget + 3u)] = bitcast<u32>(1f);\n    return;\n}\n\n@compute @workgroup_size(256, 1, 1) \nfn forgeax_vfx_trail_main(@builtin(global_invocation_id) invocation_9: vec3<u32>) {\n    let _e4 = forgeax_vfx_runtime.topology.y;\n    let historyLength_1 = max(2u, _e4);\n    let segmentCount = (historyLength_1 - 1u);\n    let _e10 = atomicLoad((&forgeax_vfx_counters.aliveCount));\n    let _e14 = forgeax_vfx_runtime.topology.z;\n    let count_3 = min(_e10, _e14);\n    let outputCount = (count_3 * segmentCount);\n    let outputRank = invocation_9.x;\n    if (outputRank == 0u) {\n        let _e25 = forgeax_vfx_runtime.topology.x;\n        forgeax_vfx_indirect[_e25].instanceCount = outputCount;\n    }\n    if (outputRank >= outputCount) {\n        return;\n    }\n    let particleRank = (outputRank / segmentCount);\n    let segment = (outputRank % segmentCount);\n    let _e33 = forgeax_vfx_runtime.tick;\n    let newest = (_e33 % historyLength_1);\n    let firstSlot = (((newest + historyLength_1) - segment) % historyLength_1);\n    let secondSlot = ((((newest + historyLength_1) - segment) - 1u) % historyLength_1);\n    let historyBase = ((particleRank * historyLength_1) * 4u);\n    let firstBase = (historyBase + (firstSlot * 4u));\n    let secondBase = (historyBase + (secondSlot * 4u));\n    let _e54 = forgeax_vfx_scratch[firstBase];\n    let _e60 = forgeax_vfx_scratch[(firstBase + 1u)];\n    let _e66 = forgeax_vfx_scratch[(firstBase + 2u)];\n    let _e72 = forgeax_vfx_scratch[(firstBase + 3u)];\n    let first = vec4<f32>(bitcast<f32>(_e54), bitcast<f32>(_e60), bitcast<f32>(_e66), bitcast<f32>(_e72));\n    let _e77 = forgeax_vfx_scratch[secondBase];\n    let _e83 = forgeax_vfx_scratch[(secondBase + 1u)];\n    let _e89 = forgeax_vfx_scratch[(secondBase + 2u)];\n    let _e95 = forgeax_vfx_scratch[(secondBase + 3u)];\n    let second = vec4<f32>(bitcast<f32>(_e77), bitcast<f32>(_e83), bitcast<f32>(_e89), bitcast<f32>(_e95));\n    let _e101 = forgeax_vfx_alive_indices[particleRank];\n    let particle_9 = forgeax_vfx_particles[_e101];\n    let _e105 = forgeax_vfx_project(first.xyz);\n    let _e107 = forgeax_vfx_project(second.xyz);\n    let base_3 = (outputRank * 12u);\n    forgeax_vfx_billboard_instances[base_3] = _e105.x;\n    forgeax_vfx_billboard_instances[(base_3 + 1u)] = _e105.y;\n    forgeax_vfx_billboard_instances[(base_3 + 2u)] = _e105.z;\n    forgeax_vfx_billboard_instances[(base_3 + 3u)] = _e107.x;\n    forgeax_vfx_billboard_instances[(base_3 + 4u)] = _e107.y;\n    forgeax_vfx_billboard_instances[(base_3 + 5u)] = _e107.z;\n    forgeax_vfx_billboard_instances[(base_3 + 6u)] = particle_9.color.x;\n    forgeax_vfx_billboard_instances[(base_3 + 7u)] = particle_9.color.y;\n    forgeax_vfx_billboard_instances[(base_3 + 8u)] = particle_9.color.z;\n    forgeax_vfx_billboard_instances[(base_3 + 9u)] = particle_9.color.w;\n    let _e169 = forgeax_vfx_runtime.billboard.x;\n    forgeax_vfx_billboard_instances[(base_3 + 10u)] = _e169;\n    forgeax_vfx_billboard_instances[(base_3 + 11u)] = (f32(segment) / f32(segmentCount));\n    return;\n}\n\n@compute @workgroup_size(256, 1, 1) \nfn forgeax_vfx_beam_main(@builtin(global_invocation_id) invocation_10: vec3<u32>) {\n    let rank_4 = invocation_10.x;\n    let _e4 = atomicLoad((&forgeax_vfx_counters.aliveCount));\n    let _e8 = forgeax_vfx_runtime.topology.z;\n    let count_4 = min(_e4, _e8);\n    if (rank_4 == 0u) {\n        let _e16 = forgeax_vfx_runtime.topology.x;\n        forgeax_vfx_indirect[_e16].instanceCount = count_4;\n    }\n    if (rank_4 >= count_4) {\n        return;\n    }\n    let _e23 = forgeax_vfx_alive_indices[rank_4];\n    let particle_10 = forgeax_vfx_particles[_e23];\n    let base_4 = (rank_4 * 12u);\n    let _e30 = forgeax_vfx_world_position(particle_10.position.xyz);\n    let worldEndpoint = (_e30 + (particle_10.velocity.xyz * particle_10.lifetime));\n    let _e36 = forgeax_vfx_project(_e30);\n    let _e37 = forgeax_vfx_project(worldEndpoint);\n    forgeax_vfx_billboard_instances[base_4] = _e36.x;\n    forgeax_vfx_billboard_instances[(base_4 + 1u)] = _e36.y;\n    forgeax_vfx_billboard_instances[(base_4 + 2u)] = _e36.z;\n    forgeax_vfx_billboard_instances[(base_4 + 3u)] = _e37.x;\n    forgeax_vfx_billboard_instances[(base_4 + 4u)] = _e37.y;\n    forgeax_vfx_billboard_instances[(base_4 + 5u)] = _e37.z;\n    forgeax_vfx_billboard_instances[(base_4 + 6u)] = particle_10.color.x;\n    forgeax_vfx_billboard_instances[(base_4 + 7u)] = particle_10.color.y;\n    forgeax_vfx_billboard_instances[(base_4 + 8u)] = particle_10.color.z;\n    forgeax_vfx_billboard_instances[(base_4 + 9u)] = particle_10.color.w;\n    let _e97 = forgeax_vfx_runtime.billboard.x;\n    forgeax_vfx_billboard_instances[(base_4 + 10u)] = _e97;\n    forgeax_vfx_billboard_instances[(base_4 + 11u)] = 0f;\n    return;\n}\n\n@compute @workgroup_size(64, 1, 1) \nfn forgeax_vfx_event_main(@builtin(global_invocation_id) invocation_11: vec3<u32>) {\n    var local_2: bool;\n    var childIndex: u32 = 0u;\n    var renderer_1: u32 = 0u;\n\n    let inputIndex = invocation_11.x;\n    if (inputIndex >= arrayLength((&forgeax_vfx_channel_inputs))) {\n        return;\n    }\n    let input = forgeax_vfx_channel_inputs[inputIndex];\n    if (input.sequence == 4294967295u) {\n        return;\n    }\n    let fanOut = max(input.reserved, 1u);\n    let _e17 = atomicAdd((&forgeax_vfx_counters.aliveCount), fanOut);\n    let _e20 = atomicAdd((&forgeax_vfx_counters.eventProduced), fanOut);\n    let _e24 = forgeax_vfx_runtime.capacity;\n    if !(((_e17 + fanOut) > _e24)) {\n        local_2 = ((_e20 + fanOut) > arrayLength((&forgeax_vfx_events)));\n    } else {\n        local_2 = true;\n    }\n    let _e34 = local_2;\n    if _e34 {\n        let _e38 = atomicAdd((&forgeax_vfx_counters.eventDropped), 1u);\n        let _e42 = atomicAdd((&forgeax_vfx_counters.eventOverflow), 1u);\n        return;\n    }\n    loop {\n        let _e44 = childIndex;\n        if (_e44 >= fanOut) {\n            break;\n        }\n        let _e46 = childIndex;\n        let childParticleIndex = (_e17 + _e46);\n        let _e48 = childIndex;\n        let childEventIndex = (_e20 + _e48);\n        let _e77 = childIndex;\n        let child = VfxParticleX_naga_oil_mod_XMZXXEZ3FMF4F65TGPA5DU4DSMVWHKZDFX(input.position, vec4<f32>(0f, (0.35f + input.strength), 0f, 0f), vec4<f32>(1f, 0.45f, 0.1f, 1f), vec4<f32>((0.1f + (input.strength * 0.15f)), (0.1f + (input.strength * 0.15f)), 0f, 0f), 0f, 0.35f, 1u, (input.sequence + _e77));\n        forgeax_vfx_particles[childParticleIndex] = child;\n        forgeax_vfx_alive_indices[childParticleIndex] = childParticleIndex;\n        let _e92 = childIndex;\n        forgeax_vfx_events[childEventIndex] = ForgeaxVfxEvent(input.position, input.strength, (input.sequence + _e92), input.channel, 0u);\n        let _e97 = childIndex;\n        childIndex = (_e97 + 1u);\n    }\n    let _e102 = atomicAdd((&forgeax_vfx_counters.eventConsumed), fanOut);\n    loop {\n        let _e104 = renderer_1;\n        let _e107 = forgeax_vfx_runtime.rendererCount;\n        if (_e104 >= _e107) {\n            break;\n        }\n        let _e110 = renderer_1;\n        forgeax_vfx_indirect[_e110].instanceCount = (_e17 + 1u);\n        let _e115 = renderer_1;\n        renderer_1 = (_e115 + 1u);\n    }\n    return;\n}\n',
+        reflection: {
+          hooks: ['vfx_spawn', 'vfx_update'],
+          imports: [
+            'forgeax_vfx::data::camera',
+            'forgeax_vfx::data::channel',
+            'forgeax_vfx::data::noise',
+            'forgeax_vfx::data::scene_depth',
+            'forgeax_vfx::prelude',
+          ],
+          resources: [
+            'particles',
+            'runtime',
+            'aliveIndices',
+            'counters',
+            'indirect',
+            'scratch',
+            'billboardInstances',
+            'channelInputs',
+            'events',
+            'eventCounters',
+          ],
+          entryPoints: [
+            'forgeax_vfx_spawn_main',
+            'forgeax_vfx_update_main',
+            'forgeax_vfx_scan_blocks_main',
+            'forgeax_vfx_scan_block_offsets_main',
+            'forgeax_vfx_add_offsets_main',
+            'forgeax_vfx_compact_main',
+            'forgeax_vfx_sort_main',
+            'forgeax_vfx_event_main',
+            'forgeax_vfx_billboard_main',
+            'forgeax_vfx_mesh_main',
+            'forgeax_vfx_ribbon_main',
+            'forgeax_vfx_trail_history_main',
+            'forgeax_vfx_trail_main',
+            'forgeax_vfx_beam_main',
+          ],
+          bindings: [
+            {
+              label: '@group(0)',
+              entries: [
+                {
+                  binding: 0,
+                  visibility: 4,
+                  buffer: {
+                    type: 'storage',
+                    hasDynamicOffset: false,
+                    minBindingSize: 0,
+                  },
+                },
+                {
+                  binding: 1,
+                  visibility: 4,
+                  buffer: {
+                    type: 'uniform',
+                    hasDynamicOffset: false,
+                    minBindingSize: 0,
+                  },
+                },
+                {
+                  binding: 2,
+                  visibility: 4,
+                  buffer: {
+                    type: 'storage',
+                    hasDynamicOffset: false,
+                    minBindingSize: 0,
+                  },
+                },
+                {
+                  binding: 3,
+                  visibility: 4,
+                  buffer: {
+                    type: 'storage',
+                    hasDynamicOffset: false,
+                    minBindingSize: 0,
+                  },
+                },
+                {
+                  binding: 4,
+                  visibility: 4,
+                  buffer: {
+                    type: 'storage',
+                    hasDynamicOffset: false,
+                    minBindingSize: 0,
+                  },
+                },
+                {
+                  binding: 5,
+                  visibility: 4,
+                  buffer: {
+                    type: 'storage',
+                    hasDynamicOffset: false,
+                    minBindingSize: 0,
+                  },
+                },
+                {
+                  binding: 6,
+                  visibility: 4,
+                  buffer: {
+                    type: 'storage',
+                    hasDynamicOffset: false,
+                    minBindingSize: 0,
+                  },
+                },
+                {
+                  binding: 8,
+                  visibility: 4,
+                  buffer: {
+                    type: 'read-only-storage',
+                    hasDynamicOffset: false,
+                    minBindingSize: 0,
+                  },
+                },
+                {
+                  binding: 9,
+                  visibility: 4,
+                  buffer: {
+                    type: 'storage',
+                    hasDynamicOffset: false,
+                    minBindingSize: 0,
+                  },
+                },
+              ],
+            },
+          ],
+          layout: {
+            version: 1,
+            parameters: {
+              name: 'VfxParameters',
+              fields: [],
+              size: 0,
+              alignment: 1,
+            },
+            custom: {
+              name: 'VfxCustom',
+              fields: [],
+              size: 0,
+              alignment: 1,
+            },
+            dataInterfaces: [],
+            fingerprint: 'sha256:2b4be36cde7f92062b2637fb080e716f8fb06b3ad9ae93ada8dc0b7a1dac98c8',
+          },
+          dataInterfaces: [],
+          eventChannels: [],
+          events: [],
+          eventEntryPoint: 'forgeax_vfx_event_main',
+          stages: [],
+          renderers: [
+            {
+              topology: 'billboard',
+              resource: 'vfx-renderer-billboard-0',
+              capacity: 4,
+              overflow: 'drop-newest',
+              enabled: true,
+              shaderInputs: [],
+            },
+            {
+              topology: 'mesh',
+              resource: 'vfx-renderer-mesh-1',
+              capacity: 1,
+              overflow: 'drop-newest',
+              enabled: true,
+              shaderInputs: ['mesh'],
+            },
+            {
+              topology: 'ribbon',
+              resource: 'vfx-renderer-ribbon-2',
+              capacity: 4,
+              overflow: 'drop-newest',
+              enabled: true,
+              shaderInputs: ['stripKey'],
+              stripKey: 'alive-index',
+            },
+            {
+              topology: 'trail',
+              resource: 'vfx-renderer-trail-3',
+              capacity: 4,
+              overflow: 'drop-newest',
+              enabled: true,
+              shaderInputs: ['history'],
+              historyLength: 4,
+            },
+            {
+              topology: 'beam',
+              resource: 'vfx-renderer-beam-4',
+              capacity: 4,
+              overflow: 'drop-newest',
+              enabled: true,
+              shaderInputs: ['endpoint'],
+              endpointField: 'velocity',
+            },
+          ],
+        },
+      },
+    ],
+  },
+};

package/src/__tests__/fog-scene-asset.integration.test.ts

@@ -0,0 +1,123 @@
+import { type EntityHandle, World } from '@forgeax/engine-ecs';
+import { Fog, SceneInstance } from '@forgeax/engine-render/internal';
+import * as SceneOwner from '@forgeax/engine-scene';
+import { ChildOf, Children, Transform } from '@forgeax/engine-scene';
+import type { SceneAsset } from '@forgeax/engine-types';
+import { describe, expect, it } from 'vitest';
+import { rootsToSceneAsset, serializeSceneAssetToPack } from '../collect-scene-asset';
+import { createSceneAssetPort, type SceneAssetPort } from '../scene-asset-port';
+
+function makeRegistry(): SceneAssetPort {
+  return createSceneAssetPort(() => undefined);
+}
+
+function registerSceneComponents(world: World): void {
+  for (const component of [SceneInstance, ChildOf, Children, Transform, Fog]) {
+    world.components.register(component).unwrap();
+  }
+}
+
+function unpackScene(pack: Record<string, unknown>): {
+  payload: Record<string, unknown>;
+  refs: string[];
+} {
+  const assets = pack.assets as Array<Record<string, unknown>> | undefined;
+  const asset = assets?.[0];
+  if (asset === undefined) throw new Error('serialized pack has no scene asset');
+  const payload = asset.payload;
+  if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) {
+    throw new Error('serialized scene payload is not an object');
+  }
+  const refs = asset.refs;
+  return {
+    payload: payload as Record<string, unknown>,
+    refs: Array.isArray(refs) ? (refs as string[]) : [],
+  };
+}
+
+function findFogEntities(world: World, root: EntityHandle): EntityHandle[] {
+  const entities: EntityHandle[] = [];
+  for (const entity of world.iterDescendants(root)) {
+    if (world.get(entity, Fog).ok) entities.push(entity);
+  }
+  return entities;
+}
+
+describe('Fog SceneAsset round-trip', () => {
+  it('collects, serializes, reloads, and instantiates two isolated Fog entities', () => {
+    const source = new World();
+    registerSceneComponents(source);
+    const first = source.spawn({
+      component: Fog,
+      data: { color: [0.2, 0.3, 0.4], density: 0.02, heightFalloff: 0.1, maxOpacity: 0.8 },
+    });
+    const second = source.spawn({
+      component: Fog,
+      data: { color: [1.5, 0.7, 0.2], density: 0.06, heightFalloff: 0.9, maxOpacity: 1 },
+    });
+    expect(first.ok).toBe(true);
+    expect(second.ok).toBe(true);
+    if (!first.ok || !second.ok) return;
+
+    const registry = makeRegistry();
+    const collected = rootsToSceneAsset(registry, source, [first.value, second.value]);
+    expect(collected.ok).toBe(true);
+    if (!collected.ok) return;
+    expect(collected.value.entities).toHaveLength(2);
+    const collectedFog = collected.value.entities.map((entity) => entity.components.Fog);
+    expect(collectedFog).toHaveLength(2);
+    expect(collectedFog[0]?.color).toEqual([0.2, 0.3, 0.4].map((value) => expect.closeTo(value)));
+    expect(collectedFog[0]?.density).toBeCloseTo(0.02);
+    expect(collectedFog[0]?.heightFalloff).toBeCloseTo(0.1);
+    expect(collectedFog[0]?.maxOpacity).toBeCloseTo(0.8);
+    expect(collectedFog[1]?.color).toEqual([1.5, 0.7, 0.2].map((value) => expect.closeTo(value)));
+    expect(collectedFog[1]?.density).toBeCloseTo(0.06);
+    expect(collectedFog[1]?.heightFalloff).toBeCloseTo(0.9);
+    expect(collectedFog[1]?.maxOpacity).toBe(1);
+
+    const serialized = serializeSceneAssetToPack(
+      collected.value,
+      new Map([['Fog', Fog]]),
+      'aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa',
+    );
+    expect(serialized.ok).toBe(true);
+    if (!serialized.ok) return;
+    const unpacked = unpackScene(serialized.value);
+
+    const loadedSceneAsset: SceneAsset = {
+      kind: 'scene',
+      entities: unpacked.payload.entities as SceneAsset['entities'],
+      ...(unpacked.payload.mounts === undefined
+        ? {}
+        : { mounts: unpacked.payload.mounts as NonNullable<SceneAsset['mounts']> }),
+    };
+
+    const destination = new World();
+    registerSceneComponents(destination);
+    const handle = destination.allocSharedRef('SceneAsset', loadedSceneAsset);
+    const instantiated = SceneOwner.worldInstantiateScene(destination, handle);
+    expect(instantiated.ok).toBe(true);
+    if (!instantiated.ok) return;
+
+    const fogEntities = findFogEntities(destination, instantiated.value.root);
+    expect(fogEntities).toHaveLength(2);
+    const values = fogEntities.map((entity) => destination.get(entity, Fog));
+    expect(values.every((result) => result.ok)).toBe(true);
+    const firstValueResult = values[0];
+    const secondValueResult = values[1];
+    if (
+      firstValueResult === undefined ||
+      secondValueResult === undefined ||
+      !firstValueResult.ok ||
+      !secondValueResult.ok
+    )
+      return;
+    const firstValue = firstValueResult.value;
+    const secondValue = secondValueResult.value;
+    expect(firstValue.color).toEqual(new Float32Array([0.2, 0.3, 0.4]));
+    expect(secondValue.color).toEqual(new Float32Array([1.5, 0.7, 0.2]));
+    expect(firstValue.color).not.toBe(secondValue.color);
+    firstValue.color[0] = 8;
+    expect(secondValue.color[0]).toBeCloseTo(1.5);
+  });
+});

package/src/__tests__/frame-targets-shadow-regression.unit.test.ts

@@ -0,0 +1,28 @@
+import { resolveShadowMapSize } from '@forgeax/engine-render/internal';
+import { describe, expect, it } from 'vitest';
+
+describe('frame targets shadow removal', () => {
+  it('fits a cascaded shadow atlas within the device texture limit', () => {
+    const internals = {
+      device: { limits: { maxTextureDimension2D: 2048 } },
+    };
+    const lights = { shadowMapSize: 2048, cascadeCount: 4 };
+
+    expect(resolveShadowMapSize(internals as never, lights as never)).toBe(1024);
+    expect(resolveShadowMapSize(internals as never, { ...lights, cascadeCount: 1 } as never)).toBe(
+      2048,
+    );
+  });
+
+  it('reserves the WebGL2 depth-texture ceiling below the generic texture limit', () => {
+    const internals = {
+      device: {
+        caps: { backendKind: 'wgpu-webgl2' },
+        limits: { maxTextureDimension2D: 2048 },
+      },
+    };
+    const lights = { shadowMapSize: 2048, cascadeCount: 1 };
+
+    expect(resolveShadowMapSize(internals as never, lights as never)).toBe(1024);
+  });
+});

package/src/__tests__/fullscreen-post-bgl-depth.test.ts

@@ -0,0 +1,131 @@
+// fullscreen-post-bgl-depth.test.ts —
+// feat-20260702-postprocess-camera-depth-read M2 / w4.
+//
+// Structural assertions for the 'fullscreen-post-with-scene-depth' BGL kind:
+// (a) 5-entry layout (color@0 + sampler@1 + params@2 + depthTex@3 + depthSampler@4).
+// (b) depthTex@3 uses sampleType:'depth', viewDimension:'2d'.
+// (c) depthSampler@4 uses type:'non-filtering' (plan-strategy D-2).
+// (d) Existing 'fullscreen-post' and 'fullscreen-post-with-params' BGL shapes
+//     are unchanged (AC-03 regression gate — pin the entry counts so a future
+//     change to those kinds breaks this test).
+
+import type { PipelineSpec } from '@forgeax/engine-render/internal';
+import { buildBindGroupLayoutDescriptor } from '@forgeax/engine-render/internal';
+import { describe, expect, it } from 'vitest';
+
+function makeSpec(colorFormats: GPUTextureFormat[] = ['rgba16float']): PipelineSpec {
+  return {
+    shader: { id: '', passKind: 'forward', variantSet: undefined },
+    attachments: { colorFormats, depthFormat: undefined, sampleCount: 1 },
+    geometry: { topology: 'triangle-list', vertexLayout: {} },
+    renderState: undefined,
+  };
+}
+
+describe('buildBindGroupLayoutDescriptor — fullscreen-post-with-scene-depth', () => {
+  it('returns label fullscreen-post-with-scene-depth-bgl', () => {
+    const spec = makeSpec();
+    const out = buildBindGroupLayoutDescriptor(spec, {
+      kind: 'fullscreen-post-with-scene-depth',
+    });
+    expect(out.label).toBe('fullscreen-post-with-scene-depth-bgl');
+  });
+
+  it('has exactly 5 entries', () => {
+    const spec = makeSpec();
+    const out = buildBindGroupLayoutDescriptor(spec, {
+      kind: 'fullscreen-post-with-scene-depth',
+    });
+    expect(out.entries).toHaveLength(5);
+  });
+
+  it('binding 0 = texture(float, 2d)', () => {
+    const spec = makeSpec();
+    const out = buildBindGroupLayoutDescriptor(spec, {
+      kind: 'fullscreen-post-with-scene-depth',
+    });
+    const e = out.entries[0];
+    expect(e?.binding).toBe(0);
+    expect(e?.visibility).toBe(0x2); // FRAGMENT
+    expect(e?.texture?.sampleType).toBe('float');
+    expect(e?.texture?.viewDimension).toBe('2d');
+  });
+
+  it('binding 1 = sampler(filtering)', () => {
+    const spec = makeSpec();
+    const out = buildBindGroupLayoutDescriptor(spec, {
+      kind: 'fullscreen-post-with-scene-depth',
+    });
+    const e = out.entries[1];
+    expect(e?.binding).toBe(1);
+    expect(e?.visibility).toBe(0x2);
+    expect(e?.sampler?.type).toBe('filtering');
+  });
+
+  it('binding 2 = buffer(uniform) — params always present (D-3)', () => {
+    const spec = makeSpec();
+    const out = buildBindGroupLayoutDescriptor(spec, {
+      kind: 'fullscreen-post-with-scene-depth',
+    });
+    const e = out.entries[2];
+    expect(e?.binding).toBe(2);
+    expect(e?.visibility).toBe(0x2);
+    expect(e?.buffer?.type).toBe('uniform');
+  });
+
+  it('binding 3 = texture(depth, 2d)', () => {
+    const spec = makeSpec();
+    const out = buildBindGroupLayoutDescriptor(spec, {
+      kind: 'fullscreen-post-with-scene-depth',
+    });
+    const e = out.entries[3];
+    expect(e?.binding).toBe(3);
+    expect(e?.visibility).toBe(0x2);
+    expect(e?.texture?.sampleType).toBe('depth');
+    expect(e?.texture?.viewDimension).toBe('2d');
+  });
+
+  it('binding 4 = sampler(non-filtering) — D-2 nearest+clamp, NOT comparison', () => {
+    const spec = makeSpec();
+    const out = buildBindGroupLayoutDescriptor(spec, {
+      kind: 'fullscreen-post-with-scene-depth',
+    });
+    const e = out.entries[4];
+    expect(e?.binding).toBe(4);
+    expect(e?.visibility).toBe(0x2);
+    expect(e?.sampler?.type).toBe('non-filtering');
+  });
+
+  describe('AC-03 regression: existing kinds unchanged', () => {
+    it("'fullscreen-post' still 2 entries", () => {
+      const spec = makeSpec();
+      const out = buildBindGroupLayoutDescriptor(spec, { kind: 'fullscreen-post' });
+      expect(out.entries).toHaveLength(2);
+    });
+
+    it("'fullscreen-post-with-params' still 3 entries", () => {
+      const spec = makeSpec();
+      const out = buildBindGroupLayoutDescriptor(spec, {
+        kind: 'fullscreen-post-with-params',
+      });
+      expect(out.entries).toHaveLength(3);
+    });
+  });
+});
+
+describe('buildBindGroupLayoutDescriptor — fullscreen-post-with-scene-depth-msaa', () => {
+  it('declares a multisampled depth texture with the same five-slot ABI', () => {
+    const out = buildBindGroupLayoutDescriptor(makeSpec(), {
+      kind: 'fullscreen-post-with-scene-depth-msaa',
+    });
+    expect(out.label).toBe('fullscreen-post-with-scene-depth-msaa-bgl');
+    expect(out.entries).toHaveLength(5);
+    expect(out.entries[2]?.buffer?.type).toBe('uniform');
+    expect(out.entries[3]?.texture).toMatchObject({
+      sampleType: 'depth',
+      viewDimension: '2d',
+      multisampled: true,
+    });
+    expect(out.entries[4]?.sampler?.type).toBe('non-filtering');
+  });
+});