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.