[add] symphonia and initial implementation.

Author: vmarcella

Cargo.lock

@@ -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

@@ -7,3 +7,6 @@
 
 #[cfg(feature = "audio-device")]
 pub mod cpal;
+
+#[cfg(any(feature = "audio-decode-wav", feature = "audio-decode-vorbis"))]
+pub mod symphonia;

crates/lambda-rs-platform/src/audio/mod.rs

@@ -0,0 +1,6 @@
+#![allow(clippy::needless_return)]
+
+//! `symphonia` dependency wrapper.
+//!
+//! This module will provide WAV and OGG Vorbis decode helpers for `lambda-rs`.
+//! It is intentionally internal and MAY change between releases.

crates/lambda-rs-platform/src/audio/symphonia/mod.rs

@@ -16,5 +16,10 @@ pub mod shader;
 pub mod wgpu;
 pub mod winit;
 
-#[cfg(feature = "audio-device")]
+#[cfg(any(
+  feature = "audio",
+  feature = "audio-device",
+  feature = "audio-decode-wav",
+  feature = "audio-decode-vorbis"
+))]
 pub mod audio;