[update] audio features to be enabled by default.

Author: vmarcella

crates/lambda-rs/Cargo.toml

@@ -20,7 +20,7 @@ cargo-audit = "0.16.0"
 mockall = "0.14.0"
 
 [features]
-default=["with-wgpu"]
+default=["with-wgpu", "audio"]
 with-vulkan=["with-wgpu", "lambda-rs-platform/wgpu-with-vulkan"]
 with-opengl=["with-wgpu", "lambda-rs-platform/wgpu-with-gl"]
 with-dx11=["with-wgpu"]
@@ -34,10 +34,10 @@ with-wgpu-gl=["with-wgpu", "lambda-rs-platform/wgpu-with-gl"]
 
 # ---------------------------------- AUDIO ------------------------------------
 
-# Umbrella features (disabled by default)
+# Umbrella features
 audio = ["audio-output-device"]
 
-# Granular feature flags (disabled by default)
+# Granular feature flags
 audio-output-device = ["lambda-rs-platform/audio-device"]
 
 # ------------------------------ RENDER VALIDATION -----------------------------

docs/features.md

@@ -3,13 +3,13 @@ title: "Cargo Features Overview"
 document_id: "features-2025-11-17"
 status: "living"
 created: "2025-11-17T23:59:00Z"
-last_updated: "2026-01-30T22:10:39Z"
-version: "0.1.7"
+last_updated: "2026-01-30T22:48:05Z"
+version: "0.1.9"
 engine_workspace_version: "2023.1.30"
 wgpu_version: "26.0.1"
 shader_backend_default: "naga"
 winit_version: "0.29.10"
-repo_commit: "939c07cf5c7ff583559c60ea7bb571961579f12b"
+repo_commit: "e179f7de3b43f9cd822b4f7ab520c095dc3c6911"
 owners: ["lambda-sh"]
 reviewers: ["engine", "rendering"]
 tags: ["guide", "features", "validation", "cargo", "audio"]
@@ -31,8 +31,8 @@ relationships, and expected behavior in debug and release builds.
 - Workspace defaults prefer `wgpu` on supported platforms and `naga` for shader compilation.
 - Debug builds enable all validations unconditionally via `debug_assertions`.
 - Release builds enable only cheap safety checks by default; validation logs and per-draw checks MUST be enabled explicitly via features.
-- Audio features are disabled by default and incur runtime cost only when an
-  audio device is initialized and kept alive.
+- Audio support in `lambda-rs` is enabled by default and incurs runtime cost
+  only when an audio device is initialized and kept alive.
 
 ## lambda-rs
 
@@ -56,9 +56,9 @@ Rendering backends
   - `with-dx11`: alias for `with-wgpu`.
 
 Audio
-- `audio` (umbrella, disabled by default): enables audio support by composing
+- `audio` (umbrella, enabled by default): enables audio support by composing
   granular audio features. This umbrella includes `audio-output-device`.
-- `audio-output-device` (granular, disabled by default): enables audio output
+- `audio-output-device` (granular, enabled by default): enables audio output
   device enumeration and callback-based audio output via `lambda::audio`. This
   feature enables `lambda-rs-platform/audio-device` internally. Expected
   runtime cost is proportional to the output callback workload and buffer size;
@@ -132,6 +132,10 @@ Audio
   backend module `lambda_platform::cpal` backed by `cpal =0.17.1`.
 
 ## Changelog
+- 0.1.9 (2026-01-30): Clarify workspace default audio behavior after enabling
+  `lambda-rs` audio features by default.
+- 0.1.8 (2026-01-30): Enable `lambda-rs` audio features by default and update
+  audio feature defaults in documentation.
 - 0.1.7 (2026-01-30): Group features by crate and document audio feature flags.
 - 0.1.6 (2026-01-25): Remove the deprecated legacy shader backend
   documentation.

docs/specs/audio-devices.md

@@ -3,13 +3,13 @@ title: "Audio Device Abstraction"
 document_id: "audio-device-abstraction-2026-01-28"
 status: "draft"
 created: "2026-01-28T22:59:00Z"
-last_updated: "2026-01-29T21:58:43Z"
-version: "0.1.9"
+last_updated: "2026-01-30T22:15:27Z"
+version: "0.1.10"
 engine_workspace_version: "2023.1.30"
 wgpu_version: "26.0.1"
 shader_backend_default: "naga"
 winit_version: "0.29.10"
-repo_commit: "e8944565ebba497ec59a72bdfdb855a97f41a666"
+repo_commit: "e179f7de3b43f9cd822b4f7ab520c095dc3c6911"
 owners: ["lambda-sh"]
 reviewers: ["engine", "rendering"]
 tags: ["spec", "audio", "lambda-rs", "platform", "cpal"]
@@ -324,10 +324,10 @@ Implementation rules
 
 Features
 
-- `lambda-rs` granular feature: `audio-output-device` (default: disabled)
+- `lambda-rs` granular feature: `audio-output-device` (default: enabled)
   - Enables the `lambda-rs::audio` output device surface.
   - Enables `lambda-rs-platform` `audio-device` internally.
-- `lambda-rs` umbrella feature: `audio` (default: disabled)
+- `lambda-rs` umbrella feature: `audio` (default: enabled)
   - Composes `audio-output-device` only.
 
 ### Application Interaction
@@ -520,10 +520,10 @@ Validation rules
 Features introduced by this spec
 
 - Crate: `lambda-rs`
-  - Granular feature: `audio-output-device` (default: disabled)
+  - Granular feature: `audio-output-device` (default: enabled)
     - Enables `lambda-rs::audio` output device APIs.
     - Enables `lambda-rs-platform` `audio-device` internally.
-  - Umbrella feature: `audio` (default: disabled)
+  - Umbrella feature: `audio` (default: enabled)
     - Composes `audio-output-device` only.
 - Crate: `lambda-rs-platform`
   - Granular feature: `audio-device` (default: disabled)
@@ -602,7 +602,7 @@ Example (lambda-rs facade)
 This example is the primary application-facing reference.
 
 - Add `crates/lambda-rs/examples/audio_sine_wave.rs` (feature:
-  `audio-output-device`) that:
+  `audio-output-device`, enabled by default) that:
   - Prints `lambda_rs::audio::enumerate_output_devices()` output.
   - Builds the default output device via the facade builder and plays a
     deterministic 440 Hz tone for at least 2 seconds.
@@ -618,21 +618,22 @@ Unit tests (crate: `lambda-rs-platform`)
 
 Commands
 
-- `cargo test -p lambda-rs --features audio-output-device -- --nocapture`
+- `cargo test -p lambda-rs -- --nocapture`
 - `cargo test -p lambda-rs-platform --features audio-device -- --nocapture`
 
 Manual checks
 
 - Run the `lambda-rs` facade example and confirm audible playback for at least
   2 seconds.
-  - `cargo run -p lambda-rs --example audio_sine_wave --features audio-output-device`
+  - `cargo run -p lambda-rs --example audio_sine_wave`
 
 ## Compatibility and Migration
 
 - None. No existing audio APIs exist in the workspace.
 
 ## Changelog
 
+- 2026-01-30 (v0.1.10) — Enable `lambda-rs` audio features by default.
 - 2026-01-29 (v0.1.9) — Fix YAML front matter to use a single `version` field.
 - 2026-01-29 (v0.1.8) — Make the `lambda-rs` facade example the primary
   reference and remove the platform example requirement.