tca-types 0.1.0

Core type definitions for Terminal Colors Architecture
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

# tca-types

Core type definitions for Terminal Colors Architecture (TCA).

## Overview

Provides domain types for representing TCA themes. This crate is format-agnostic and contains no I/O or rendering logic.

## Installation

```toml
[dependencies]
tca-types = "0.1"
```

## Usage

```rust
use tca_types::Theme;

// Themes are deserialized from TOML
let theme: Theme = toml::from_str(toml_content)?;

// Resolve palette references to hex colors
let color = theme.resolve("palette.red.5"); // Returns Some("#ff5555")
let direct = theme.resolve("#ff0000");       // Returns Some("#ff0000")

// Convert hex to RGB
use tca_types::hex_to_rgb;
let (r, g, b) = hex_to_rgb("#ff5555")?;
```

## Type Structure

```
Theme
 - Theme      - Name, author, version, description
 - Ansi       - 16 ANSI color definitions
 - Palette    - Neutral and hue ramps (red, blue, green, etc.)
 - Base16     - Optional Base16 scheme
 - Semantic   - Optional semantic colors (error, warning, etc.)
 - Ui         - Optional UI colors (background, foreground, etc.)
```

## Color References

TCA supports two reference formats:

- **Hex colors:** `#ff0000`
- **Palette references:** `palette.red.5`

The `Theme::resolve()` method resolves references to hex values.

## Serialization

All types derive `Serialize` and `Deserialize` for use with serde.

## License

MIT