[update] documentation to point to new demo locations.

Author: vmarcella

README.md

@@ -134,26 +134,27 @@ Start with the tutorials to build features step by step:
 
 ## Examples <a name="examples"></a>
 
-Browse example sources:
+Browse runnable demos and example sources:
 
-* Core API examples: [crates/lambda-rs/examples/](./crates/lambda-rs/examples/)
+* Demo crates (recommended): [demos/](./demos/)
+* Minimal rustdoc examples: [crates/lambda-rs/examples/](./crates/lambda-rs/examples/)
 * Logging examples: [crates/lambda-rs-logging/examples/](./crates/lambda-rs-logging/examples/)
 * Argument parsing examples: [crates/lambda-rs-args/examples/](./crates/lambda-rs-args/examples/)
 
 ### Minimal
 
-A minimal example of an application with a working window using lambda.
+A minimal demo of an application with a working window using lambda.
 
-```rust
-cargo run --example minimal
+```bash
+cargo run -p lambda-demos-minimal --bin minimal
 ```
 
 ### Immediates
 
 An example of using shaders with immediates (per-draw data) to render a 3D image.
 
-```rust
-cargo run --example immediates
+```bash
+cargo run -p lambda-demos-render --bin immediates
 ```
 
 #### Notes
@@ -166,16 +167,16 @@ in either dx11 or dx12.
 
 An example using shaders to render a single triangle.
 
-```rust
-cargo run --example triangle
+```bash
+cargo run -p lambda-demos-render --bin triangle
 ```
 
 ### Triangles
 
 An example using shaders to render multiple triangles and keyboard input to move one of the triangles on screen.
 
-```rust
-cargo run --example triangles
+```bash
+cargo run -p lambda-demos-render --bin triangles
 ```
 
 ## Plans <a name="plans"></a>

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-02-02T22:57:02Z"
-version: "0.1.17"
+last_updated: "2026-02-05T23:05:40Z"
+version: "0.1.18"
 engine_workspace_version: "2023.1.30"
 wgpu_version: "26.0.1"
 shader_backend_default: "naga"
 winit_version: "0.29.10"
-repo_commit: "6a5fd409c8097665ffd6e6a4a976206320ae4f80"
+repo_commit: "544444652b4dc3639f8b3e297e56c302183a7a0b"
 owners: ["lambda-sh"]
 reviewers: ["engine", "rendering"]
 tags: ["spec", "audio", "lambda-rs", "platform", "cpal"]
@@ -625,7 +625,7 @@ Feature gating requirements
   - [x] `docs/features.md` updated with audio feature documentation
         (`docs/features.md`)
   - [x] Example added demonstrating audible playback (behind `audio-output-device`)
-        (`crates/lambda-rs/examples/audio_sine_wave.rs`)
+        (`demos/audio/src/bin/sine_wave.rs`)
   - [x] `lambda-rs` audio facade implemented (`crates/lambda-rs/src/audio/mod.rs`)
 
 ## Verification and Testing
@@ -634,8 +634,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`, disabled by default) that:
+- Add `demos/audio/src/bin/sine_wave.rs` (crate: `lambda-demos-audio`) that:
   - Prints `lambda::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.
@@ -658,14 +657,15 @@ 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-demos-audio --bin sine_wave`
 
 ## Compatibility and Migration
 
 - None. No existing audio APIs exist in the workspace.
 
 ## Changelog
 
+- 2026-02-05 (v0.1.18) — Update demo and example references for `demos/`.
 - 2026-02-02 (v0.1.17) — Align specification file references with the current
   `lambda::audio` module layout and feature composition.
 - 2026-01-31 (v0.1.15) — Update verification command to include

docs/specs/audio-file-loading.md

@@ -3,13 +3,13 @@ title: "Audio File Loading (SoundBuffer)"
 document_id: "audio-file-loading-2026-01-31"
 status: "draft"
 created: "2026-01-31T22:07:49Z"
-last_updated: "2026-02-02T22:57:02Z"
-version: "0.2.2"
+last_updated: "2026-02-05T23:05:40Z"
+version: "0.2.3"
 engine_workspace_version: "2023.1.30"
 wgpu_version: "26.0.1"
 shader_backend_default: "naga"
 winit_version: "0.29.10"
-repo_commit: "6a5fd409c8097665ffd6e6a4a976206320ae4f80"
+repo_commit: "544444652b4dc3639f8b3e297e56c302183a7a0b"
 owners: ["lambda-sh"]
 reviewers: ["engine", "rendering"]
 tags: ["spec", "audio", "lambda-rs", "platform", "assets"]
@@ -308,7 +308,7 @@ Recommendations
   - [x] `docs/features.md` updated with new features and defaults
         (`docs/features.md`)
   - [x] Minimal example loads a sound file and prints metadata
-        (`crates/lambda-rs/examples/sound_buffer_load.rs`)
+        (`demos/audio/src/bin/sound_buffer.rs`)
 - Tests
   - [x] Unit tests cover WAV mono and stereo
         (`crates/lambda-rs-platform/src/audio/symphonia/mod.rs`)
@@ -341,7 +341,7 @@ Commands
 
 ### Example
 
-- Provide `crates/lambda-rs/examples/sound_buffer_load.rs`.
+- Provide `demos/audio/src/bin/sound_buffer.rs`.
 - The example SHOULD load a file path provided via CLI args and print:
   - channels
   - sample rate
@@ -356,6 +356,7 @@ Commands
 
 ## Changelog
 
+- 2026-02-05 (v0.2.3) — Update example references to demo crates under `demos/`.
 - 2026-02-02 (v0.2.2) — Align spec with feature-gated `SoundBuffer` surface and
   implemented fixtures.
 - 2026-01-31 (v0.2.0) — Center decoding on `symphonia` 0.5.5.

docs/specs/component-event-handling.md

@@ -3,13 +3,13 @@ title: "Component Event Handling"
 document_id: "component-event-handling-2026-01-10"
 status: "draft"
 created: "2026-01-10T00:00:00Z"
-last_updated: "2026-01-16T00:00:00Z"
-version: "0.1.1"
+last_updated: "2026-02-05T23:05:40Z"
+version: "0.1.2"
 engine_workspace_version: "2023.1.30"
 wgpu_version: "26.0.1"
 shader_backend_default: "naga"
 winit_version: "0.29.10"
-repo_commit: "9435ad1491b5930054117406abe08dd1c37f2102"
+repo_commit: "544444652b4dc3639f8b3e297e56c302183a7a0b"
 owners: ["lambda-sh"]
 reviewers: ["engine", "rendering"]
 tags: ["spec", "events", "components", "runtime"]
@@ -227,7 +227,7 @@ winit event loop
     `crates/lambda-rs/src/runtimes/application.rs`)
 - Documentation and Examples
   - [x] Examples updated to implement `event_mask` and granular handlers (Ref:
-    `crates/lambda-rs/examples/`)
+    `demos/render/src/bin/`)
   - [x] `docs/features.md` checked for relevance (no new features expected)
     (Ref: `docs/features.md`)
   - [x] Migration notes added to component documentation (Ref:
@@ -268,5 +268,6 @@ path that demonstrates the implementation.
 
 ## Changelog
 
+- 2026-02-05 (v0.1.2) — Update example references to demo crates under `demos/`.
 - 2026-01-16 (v0.1.1) — Update checklist references and align docs.
 - 2026-01-10 (v0.1.0) — Initial draft.

docs/specs/depth-stencil-msaa.md

@@ -3,13 +3,13 @@ title: "Depth/Stencil and Multi-Sample Rendering"
 document_id: "depth-stencil-msaa-2025-11-11"
 status: "draft"
 created: "2025-11-11T00:00:00Z"
-last_updated: "2025-12-15T00:00:00Z"
-version: "0.5.0"
+last_updated: "2026-02-05T23:05:40Z"
+version: "0.5.1"
 engine_workspace_version: "2023.1.30"
 wgpu_version: "26.0.1"
 shader_backend_default: "naga"
 winit_version: "0.29.10"
-repo_commit: "71256389b9efe247a59aabffe9de58147b30669d"
+repo_commit: "544444652b4dc3639f8b3e297e56c302183a7a0b"
 owners: ["lambda-sh"]
 reviewers: ["engine", "rendering"]
 tags: ["spec", "rendering", "depth", "stencil", "msaa"]
@@ -248,8 +248,8 @@ Always-on safeguards (release and debug)
     and 4; verify occlusion and smoother edges when multi-sampling is enabled.
   - Commands: `cargo test --workspace`
 - Manual Checks (if necessary)
-  - Run `cargo run --example minimal` with a toggle for multi-sampling and
-    observe aliasing reduction with 4x multi-sampling.
+  - Run `cargo run -p lambda-demos-minimal --bin minimal` with a toggle for
+    multi-sampling and observe aliasing reduction with 4x multi-sampling.
 
 ## Compatibility and Migration
 
@@ -259,6 +259,7 @@ Always-on safeguards (release and debug)
 
 ## Changelog
 
+- 2026-02-05 (v0.5.1) — Update demo run commands for `demos/`.
 - 2025-12-15 (v0.5.0) — Update example code to use `render_context.gpu()` and add `surface_format`/`depth_format` parameters to `RenderPassBuilder` and `RenderPipelineBuilder`.
 - 2025-11-21 (v0.4.1) — Clarify depth attachment and clear behavior for
   stencil-only passes; align specification with engine behavior that preserves

docs/specs/indexed-draws-and-multiple-vertex-buffers.md

@@ -3,13 +3,13 @@ title: "Indexed Draws and Multiple Vertex Buffers"
 document_id: "indexed-draws-multiple-vertex-buffers-2025-11-22"
 status: "draft"
 created: "2025-11-22T00:00:00Z"
-last_updated: "2025-12-15T00:00:00Z"
-version: "0.2.0"
+last_updated: "2026-02-05T23:05:40Z"
+version: "0.2.1"
 engine_workspace_version: "2023.1.30"
 wgpu_version: "26.0.1"
 shader_backend_default: "naga"
 winit_version: "0.29.10"
-repo_commit: "71256389b9efe247a59aabffe9de58147b30669d"
+repo_commit: "544444652b4dc3639f8b3e297e56c302183a7a0b"
 owners: ["lambda-sh"]
 reviewers: ["engine", "rendering"]
 tags: ["spec", "rendering", "vertex-input", "indexed-draws"]
@@ -271,7 +271,7 @@ let commands = vec![
   - Example: an indexed mesh rendered with two vertex buffers (positions and colors) and a 16-bit index buffer.
   - Example: fall back to non-indexed draws for simple meshes to ensure both paths remain valid.
   - Commands:
-    - `cargo run -p lambda-rs --example indexed_multi_vertex_buffers`
+    - `cargo run -p lambda-demos-render --bin indexed_multi_vertex_buffers`
     - `cargo test --workspace`
 - Manual Checks (optional)
   - Render a mesh with and without indexed draws and visually confirm identical geometry.
@@ -285,6 +285,7 @@ let commands = vec![
 
 ## Changelog
 
+- 2026-02-05 (v0.2.1) — Update demo and example references for `demos/`.
 - 2025-12-15 (v0.2.0) — Update example code to use `render_context.gpu()` and add `surface_format`/`depth_format` parameters to `RenderPipelineBuilder`.
 - 2025-11-22 (v0.1.0) — Initial draft specifying indexed draws and multiple vertex buffers, including API surface, behavior, validation hooks, performance guidance, and verification plan.
 - 2025-11-22 (v0.1.1) — Added engine-level `IndexFormat`, instance ranges to `Draw`/`DrawIndexed`, encoder-side validation for pipeline and index buffer bindings, and updated requirements checklist.

docs/specs/offscreen-render-targets-and-multipass.md

@@ -3,13 +3,13 @@ title: "Offscreen Render Targets and Multipass Rendering"
 document_id: "offscreen-render-targets-2025-11-25"
 status: "draft"
 created: "2025-11-25T00:00:00Z"
-last_updated: "2025-12-29T00:00:00Z"
-version: "0.2.5"
+last_updated: "2026-02-05T23:05:40Z"
+version: "0.2.6"
 engine_workspace_version: "2023.1.30"
 wgpu_version: "26.0.1"
 shader_backend_default: "naga"
 winit_version: "0.29.10"
-repo_commit: "bc191ae9d47e9339390b9c21e47933a36d737987"
+repo_commit: "544444652b4dc3639f8b3e297e56c302183a7a0b"
 owners: ["lambda-sh"]
 reviewers: ["engine", "rendering"]
 tags: ["spec", "rendering", "offscreen", "multipass"]
@@ -377,7 +377,7 @@ Gating requirements
   - [x] Pass/pipeline/destination compatibility checks implemented.
   - [x] `docs/features.md` updated to list the feature, default state, and cost.
 - Documentation and Examples
-  - [x] Minimal render-to-texture example added under `crates/lambda-rs/examples/`.
+  - [x] Minimal render-to-texture example added under `demos/render/src/bin/offscreen_post.rs`.
   - [ ] Rendering guide updated to include an offscreen multipass walkthrough.
   - [ ] Migration notes added for consumers adopting destination-based passes.
 
@@ -397,7 +397,7 @@ Gating requirements
   - Render-to-texture example:
     - Pass 1: scene → offscreen destination.
     - Pass 2: fullscreen quad sampling `offscreen.color_texture()` → surface.
-  - Commands: `cargo run -p lambda-rs --example offscreen_post`
+  - Commands: `cargo run -p lambda-demos-render --bin offscreen_post`
 - Manual checks
   - Visual confirmation that:
     - Offscreen-only passes do not produce visible output until sampled.
@@ -420,6 +420,7 @@ Gating requirements
 
 ## Changelog
 
+- 2026-02-05 (v0.2.6) — Update demo and example references for `demos/`.
 - 2025-12-29 (v0.2.5) — Remove references to `lambda::render::target` and
   `lambda::render::render_target` compatibility shims; document
   `lambda::render::targets::{surface,offscreen}` as the canonical module

docs/specs/uniform-buffers-and-bind-groups.md

@@ -3,13 +3,13 @@ title: "Uniform Buffers and Bind Groups"
 document_id: "ubo-spec-2025-10-11"
 status: "living"
 created: "2025-10-11T00:00:00Z"
-last_updated: "2025-12-15T00:00:00Z"
-version: "0.5.0"
+last_updated: "2026-02-05T23:05:40Z"
+version: "0.5.1"
 engine_workspace_version: "2023.1.30"
 wgpu_version: "26.0.1"
 shader_backend_default: "naga"
 winit_version: "0.29.10"
-repo_commit: "71256389b9efe247a59aabffe9de58147b30669d"
+repo_commit: "544444652b4dc3639f8b3e297e56c302183a7a0b"
 owners: ["lambda-sh"]
 reviewers: ["engine", "rendering"]
 tags: ["spec", "rendering", "uniforms", "bind-groups", "wgpu"]
@@ -278,7 +278,7 @@ RC::SetBindGroup { set: 0, group: dyn_group_id, dynamic_offsets: offsets };
   - [x] Dynamic offsets example provided — docs/specs/uniform-buffers-and-bind-groups.md
 - Documentation and Examples
   - [x] Spec updated (this document)
-  - [x] Example added — crates/lambda-rs/examples/uniform_buffer_triangle.rs
+  - [x] Example added — demos/render/src/bin/uniform_buffer_triangle.rs
 
 ## Verification and Testing
 
@@ -288,8 +288,8 @@ RC::SetBindGroup { set: 0, group: dyn_group_id, dynamic_offsets: offsets };
   - Command encoding satisfies device limits — crates/lambda-rs/src/render/command.rs
   - Command: `cargo test --workspace`
 - Integration tests and examples
-  - `uniform_buffer_triangle` exercises the full path — crates/lambda-rs/examples/uniform_buffer_triangle.rs
-  - Command: `cargo run -p lambda-rs --example uniform_buffer_triangle`
+  - `uniform_buffer_triangle` exercises the full path — demos/render/src/bin/uniform_buffer_triangle.rs
+  - Command: `cargo run -p lambda-demos-render --bin uniform_buffer_triangle`
 - Manual checks (optional)
   - Validate dynamic offsets across multiple objects render correctly (no
     misaligned reads) by varying object counts and strides.
@@ -302,6 +302,7 @@ RC::SetBindGroup { set: 0, group: dyn_group_id, dynamic_offsets: offsets };
 
 ## Changelog
 
+- 2026-02-05 (v0.5.1) — Update demo and example references for `demos/`.
 - 2025-12-15 (v0.5.0) — Update example code to use `rc.gpu()` and add `surface_format`/`depth_format` parameters to `RenderPipelineBuilder`.
 - 2025-10-17 (v0.4.0) — Restructure to match spec template: add Summary, Scope,
   Terminology, Design (API/Behavior/Validation), Constraints and Rules,