[update] structure to group audio dependencies together.

vmarcella · vmarcella · commit 50623da120c3 · 2026-01-31T14:47:05.000-08:00
diff --git a/crates/lambda-rs-platform/src/audio/cpal/device.rs b/crates/lambda-rs-platform/src/audio/cpal/device.rs
@@ -1,6 +1,6 @@
 #![allow(clippy::needless_return)]
 
-//! Audio output device discovery and stream initialization.
+//! Audio output device discovery and stream initialization (cpal backend).
 //!
 //! This module defines a backend-agnostic surface that `lambda-rs` can use to
 //! enumerate and initialize audio output devices. The implementation is
diff --git a/crates/lambda-rs-platform/src/audio/cpal/mod.rs b/crates/lambda-rs-platform/src/audio/cpal/mod.rs
@@ -1,6 +1,6 @@
 #![allow(clippy::needless_return)]
 
-//! Internal audio backend abstractions used by `lambda-rs`.
+//! Internal audio backend abstractions used by `lambda-rs` (cpal backend).
 
 pub mod device;
 
diff --git a/crates/lambda-rs-platform/src/audio/mod.rs b/crates/lambda-rs-platform/src/audio/mod.rs
@@ -0,0 +1,9 @@
+#![allow(clippy::needless_return)]
+
+//! Internal audio dependency wrappers used by `lambda-rs`.
+//!
+//! This module is internal to the engine. Applications MUST NOT depend on
+//! `lambda-rs-platform` directly.
+
+#[cfg(feature = "audio-device")]
+pub mod cpal;
diff --git a/crates/lambda-rs-platform/src/lib.rs b/crates/lambda-rs-platform/src/lib.rs
@@ -17,4 +17,4 @@ pub mod wgpu;
 pub mod winit;
 
 #[cfg(feature = "audio-device")]
-pub mod cpal;
+pub mod audio;
diff --git a/crates/lambda-rs/src/audio.rs b/crates/lambda-rs/src/audio.rs
@@ -7,7 +7,7 @@
 //! `lambda-rs-platform` and MUST NOT be exposed through the `lambda-rs` public
 //! API.
 
-use lambda_platform::cpal as platform_audio;
+use lambda_platform::audio::cpal as platform_audio;
 
 /// Output sample format used by an audio stream callback.
 #[derive(Clone, Copy, Debug, PartialEq, Eq)]
