Documentation article
Run your first transformation
Run one schema through the full pipeline and inspect both the output and the diagnostics.
The fastest way to understand the toolkit is to move one schema through the full parse -> Shape IR -> generate flow.
A good first transformation is simple enough to inspect by eye but rich enough to show that the IR is doing real structural work for you.
The first run should teach you where the toolkit is already deterministic and where downstream formats still force tradeoffs.
When the transformation succeeds, inspect the resulting schema for preserved field names, container shapes, and obvious constraints.
When you see warnings or caveats, treat them as part of the normal workflow. They tell you where a target format cannot carry the same meaning cleanly.
This kind of compact schema is ideal for a first pass because you can quickly tell whether object properties, arrays, and enums stayed intact.
A compact first input
type Source = {
id: string;
tags: string[];
status: "draft" | "published";
};