US-6.3.2: Exhaustive API documentation with examples

## User Story
> As a Rust developer, I want comprehensive API docs with examples.

## Acceptance Criteria
- [ ] `#[doc]` on all public functions/structs/traits
- [ ] Runnable examples (`/// # Examples`) for key methods
- [ ] `cargo doc` without warnings