# Toons (code folder)

Source code for `AcToonSerializer` — Token-Oriented Object Notation, the LLM-optimized serialization format.

> **Domain documentation:** [`../../docs/TOON/README.md`](../../docs/TOON/README.md). This file is only a local file index.

## Files in this folder

- `AcToonSerializer.cs` — main entry point (public `Serialize` / `SerializeTypeMetadata` / `SerializeMetadata` API).
- `AcToonSerializer.*.cs` — 14 partial class files split topically (MetaWriter, DataSection, TypeDefinitions, Descriptions, Attributes, AttributeExtraction, Placeholders, TopologicalSort, Navigation, ForeignKeys, Validation, ToonSerializationContext, ToonSerializeTypeMetadata).
- `AcToonSerializerOptions.cs` — options POCO, `ToonSerializationMode` enum, preset factories.
- `AcToonContextBase.cs` — shared base for serialization contexts.
- `ToonDescriptionAttribute.cs` — `[ToonDescription]` attribute + `ToonRelationType` enum.
- `ToonTypeRelation.cs` — type relation string constants (`BaseOf`, `DtoOf`, `ModelOf`, etc.).

## Cross-references

- Shared serializer infrastructure (metadata cache, reference tracking, `IdentityMap`): [`../README.md`](../README.md).
- Full Toon docs: [`../../docs/TOON/`](../../docs/TOON/README.md).
