Architecture Overview
Understand how the grammar-aware parser and conversion engine work under the hood.
The Engine Lifecycle
The following diagram illustrates the structural relationships between Saturon's modules and the lifecycle of a color as it passes through the system: from a raw CSS string down to a standardized formatted output.
Architecture Deep Dives
Explore the five core pillars that make up Saturon to understand how data flows through each pipeline, and how you can extend them:
Dual-Path Parsing
Learn how Saturon optimizes performance by splitting parsing into a fast "Shortcuts" lane for simple strings and a robust Lexer/Grammar pipeline for complex CSS functions.
Graph Pathfinding
Discover how dynamic Bidirectional Graph (BFS) pathfinding eliminates the need for exhaustive, hardcoded conversion matrices between color models.
Gamut Mapping
Understand how out-of-bounds wide-gamut coordinates are intelligently fitted to renderable targets using customizable mapping algorithms.
Formatting & Serialization
See how normalized, internal coordinates are cleanly serialized back into spec-compliant CSS strings, hex codes, or custom formats.
Extensibility
Find out how to leverage the decoupled architecture to inject entirely new color spaces, custom syntaxes, and formatters directly into the engine.
