# use-theme
Theme identity and mode primitives for RustUse UI.
## Purpose
`use-theme` describes theme names, variants, display modes, and semantic theme roles. It intentionally avoids color math, contrast checks, palette generation, and the deeper responsibilities of `use-color`.
## Example
```rust
use use_theme::{SemanticThemeRole, ThemeMode, ThemeName, ThemeVariant};
let name = ThemeName::new("Acme");
let variant = ThemeVariant::new("high-contrast");
assert_eq!(name.as_str(), "Acme");
assert_eq!(variant.as_str(), "high-contrast");
assert_eq!(ThemeMode::Dark.as_str(), "dark");
assert_eq!(SemanticThemeRole::Primary.as_str(), "primary");
```
## Main types
- `ThemeMode`
- `ThemeName`
- `ThemeVariant`
- `SemanticThemeRole`
## Facade relationship
The `use-ui` facade exposes this crate as `use_ui::theme` when the `theme` or `full` feature is enabled.