Specification and behavior

The draft v1 specification records the original syntax-scanner, schema-rendering, registration, and generated-code design. It predates Optional[T], Nullable[T], and direct slices of registered interfaces, so it is not a complete reference for the current release.

Use these pages and their linked compiling examples for current behavior:

• Getting started for installation and the two build-tagged files.
• Optional and nullable for required, omitted, and null properties.
• Enums and Interfaces for field-level registrations.
• Shared definitions (AsRef) for $ref/$defs instead of inlining.
• Provider schemas for runtime schema customization.
• Validation and CI for JSON validation and drift checks.

Use the draft specification as design background when changing the generator, then verify the current source, examples, generated output, and tests before relying on a subtle implementation guarantee.