Concepts
These pages explain why PistonConfig separates format backends, the core model, typed access styles, and operational workflows.
Architecture
Design Goals
Why configuration files are treated as both data and documents.
Lossless Configuration
How values, comments, decorations, and metadata stay separate.
Round Tripping
What preservation means when different formats expose different detail.
Type Safety
How codecs, records, annotations, and static properties keep call sites typed.