feat(lambda-rs): Implement a SoundBuffer with support for decoding wav and ogg files

Author: vmarcella

.gitattributes

@@ -1 +1,4 @@
 *.png filter=lfs diff=lfs merge=lfs -text
+*.wav filter=lfs diff=lfs merge=lfs -text
+*.ogg filter=lfs diff=lfs merge=lfs -text
+*.oga filter=lfs diff=lfs merge=lfs -text

.github/workflows/compile_lambda_rs.yml

@@ -42,6 +42,8 @@ jobs:
     steps:
       - name: Checkout Repository
         uses: actions/checkout@v4
+        with:
+          lfs: true
 
       - name: Cache cargo builds
         uses: Swatinem/rust-cache@v2
@@ -87,14 +89,30 @@ jobs:
           cargo +nightly-2025-09-26 fmt --all --check
 
       - name: Build workspace
+        if: ${{ contains(matrix.features, 'lambda-rs/audio-output-device') }}
         run: cargo build --workspace --features ${{ matrix.features }}
 
+      - name: Build workspace (exclude audio tools)
+        if: ${{ !contains(matrix.features, 'lambda-rs/audio-output-device') }}
+        run: |
+          cargo build --workspace \
+            --exclude lambda-audio-tool \
+            --features ${{ matrix.features }}
+
       - name: Build examples (lambda-rs)
         run: cargo build -p lambda-rs --examples --features ${{ matrix.features }}
 
       - name: Test workspace
+        if: ${{ contains(matrix.features, 'lambda-rs/audio-output-device') }}
         run: cargo test --workspace --features ${{ matrix.features }}
 
+      - name: Test workspace (exclude audio tools)
+        if: ${{ !contains(matrix.features, 'lambda-rs/audio-output-device') }}
+        run: |
+          cargo test --workspace \
+            --exclude lambda-audio-tool \
+            --features ${{ matrix.features }}
+
       - uses: actions/setup-ruby@v1
       - name: Send Webhook Notification for build status.
         if: ${{ github.ref == 'refs/heads/main' }}

.github/workflows/coverage.yml

@@ -30,6 +30,7 @@ jobs:
         with:
           # Fetch enough history for diff against base branch
           fetch-depth: 0
+          lfs: true
 
       - name: Cache cargo builds
         uses: Swatinem/rust-cache@v2

.github/workflows/lambda-repo-security.yml

@@ -41,6 +41,11 @@ jobs:
       - name: Install dependencies for converting clippy output to SARIF
         run: cargo install clippy-sarif sarif-fmt
 
+      - name: Install Linux deps for audio
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libasound2-dev
+
       - name: Check formatting
         run: |
           rustup component add rustfmt --toolchain nightly-2025-09-26

.github/workflows/release.yml

@@ -60,10 +60,22 @@ jobs:
         run: cargo fmt --all -- --check
 
       - name: Clippy
-        run: cargo clippy --workspace --all-targets -- -D warnings
+        run: |
+          cargo clippy --workspace \
+            # Excluded in the release workflow to avoid pulling in Linux ALSA
+            # build dependencies (`alsa-sys`) that are unnecessary for release
+            # binaries. Audio/tool validation runs in the CI build matrix when
+            # audio features are enabled.
+            --exclude lambda-audio-tool \
+            --all-targets \
+            -- -D warnings
 
       - name: Tests
-        run: cargo test --workspace -- --nocapture
+        run: |
+          cargo test --workspace \
+            # See note above in the Clippy step.
+            --exclude lambda-audio-tool \
+            -- --nocapture
 
   prepare_version:
     name: Prepare version, tag, push
@@ -221,7 +233,10 @@ jobs:
         shell: bash
         run: |
           set -euo pipefail
-          cargo build --workspace --release --bins
+          # See note in the validate job: `lambda-audio-tool` is excluded here
+          # to avoid Linux ALSA build dependencies that are unnecessary for
+          # release artifacts.
+          cargo build --workspace --exclude lambda-audio-tool --release --bins
 
       - name: Stage files
         id: stage

Cargo.lock

@@ -8,6 +8,7 @@ members = [
   "crates/lambda-rs-logging",
   "crates/lambda-rs-platform",
   "tools/obj_loader",
+  "tools/lambda_audio",
 ]
 
 default-members = [

Cargo.toml

@@ -23,6 +23,12 @@ wgpu = { version = "=28.0.0", optional = true, features = ["wgsl", "spirv"] }
 pollster = { version = "=0.4.0", optional = true }
 lambda-rs-logging = { path = "../lambda-rs-logging", version = "2023.1.30" }
 cpal = { version = "=0.17.1", optional = true }
+symphonia = { version = "=0.5.5", optional = true, default-features = false, features = [
+  "ogg",
+  "vorbis",
+  "wav",
+  "pcm",
+] }
 
 # Force windows crate to 0.62 to unify wgpu-hal and gpu-allocator dependencies.
 # Both crates support this version range, but Cargo may resolve to different
@@ -53,7 +59,9 @@ wgpu-with-gl = ["wgpu", "wgpu/webgl"]
 # ---------------------------------- AUDIO ------------------------------------
 
 # Umbrella features (disabled by default)
-audio = ["audio-device"]
+audio = ["audio-device", "audio-decode-wav", "audio-decode-vorbis"]
 
 # Granular feature flags (disabled by default)
 audio-device = ["dep:cpal"]
+audio-decode-wav = ["dep:symphonia"]
+audio-decode-vorbis = ["dep:symphonia"]

crates/lambda-rs-platform/Cargo.toml

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:fb635f26da26ae2dadd8560ed3e0451381b90e7b5abfbe3303ec33f27f340e43
+size 14370

crates/lambda-rs-platform/assets/audio/slash_vorbis_stereo_48000.ogg

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:7241cee48cae37e67abcac3aa06fbf1c478828c896fc92d594605d9e44721476
+size 35336