# API Doc Entity

### Scope

- **Purpose**: Document the public API of `color_tools` — types, methods, traits, and compatibility guarantees.
- **Responsibility**: Collect one doc instance per public type or API surface; each instance owns operations, error handling, and compatibility guarantees.
- **In Scope**: Public type operations, conversion traits, error handling policy, and semver stability.
- **Out of Scope**: Feature design rationale (→ `feature/`); behavioral contracts (→ `invariant/`).

### Overview Table

| ID | Name | Purpose | Status |
|----|------|---------|--------|
| 001 | [DecoratedText Type](001_decorated_text_type.md) | Public API for constructing, coloring, and rendering text | ✅ |
| 002 | [Color Type](002_color_type.md) | Public API for the `Color` enum — variants, `to_ansi()`, and SGR mapping | ✅ |
