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

.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.toml

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

crates/lambda-rs-platform/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"]