src/palette/context.md

# Palette Module

Color quantization and palette generation

## Purpose

- Quantize colors to fixed palettes
- Map arbitrary colors to palette entries
- Perform color space conversions

## Layout

```
palette/
├── context.md      # This file
├── __init__.py     # API: create_palette()
├── quantizer.py    # K-means clustering
├── mapper.py       # Color-to-palette mapping
└── color_space.py  # RGB/LAB conversions
```

## Scope

- In-scope: Color quantization, LAB space clustering, nearest neighbor mapping
- Out-of-scope: Image processing, texture generation

## Entrypoints

- `create_palette(colors, size)` - Generate palette
- `PaletteMapper(palette)` - Map colors to palette
- `quantize_colors(colors, n_colors)` - K-means quantization

## Dependencies

- Internal: color_space
- External: NumPy, scikit-learn, SciPy