internal/

Package annotation reads the documentation-adjacent facts a schema or a carrier declares — descriptions, deprecation, visibility, XML hints, extensions — and the validation-only JSON Schema keywords the IR keeps verbatim rather than models.

Package auth lowers what a document says about authentication: the security schemes it declares, and the requirements that name them.

Package diag holds the OpenAPI compiler's diagnostic vocabulary: the stable codes it reports under, and the single constructor that builds a diagnostic from them.

Package ids derives IR identifiers from OpenAPI source coordinates: the RFC 6901 pointer arithmetic that names a position, and the namespace each kind of node is addressed in.

Package load turns one source document into a parsed, reference-resolved OpenAPI document plus the identity metadata the rest of the compiler stamps into the IR.

Package lowering holds the immutable context every OpenAPI lowering reads.

Package merge reconciles the properties more than one allOf branch declares: either folding two declarations into one or reporting that they disagree.

Package nodeview reads a YAML mapping the way the resolver will: through aliases, through `<<` merge keys, and with duplicate keys resolved the way the parser resolves them.

Package openapitest holds the test scaffolding every test package under compilers/openapi would otherwise carry as its own copy.

Package operation lowers what a document says an API does: its path items, webhooks and callbacks, the parameters merged onto each operation, and the content of every request body, response and header.

Package overlay applies an OpenAPI Overlay document to the parsed node tree, and records which positions in the result the overlay is answerable for.

Package resolve answers what a $ref names: which same-document pointer it addresses, which interned type, if any, already lives there, and — for the components that are not schemas — which concrete value and declaration site a reference-or-inline entry stands for.

Package scan refuses a source document before any of it is lowered.

Package schema lowers OpenAPI schemas into IR types: the shape walk itself, the compositions written around it, the references that reach other schemas, and the preservation of what the IR has no field for.

Package sourceindex answers, in one walk, the questions asked of a decoded source tree before any of it is lowered.

Package value lowers source scalars into ir.Value, keeping numeric literals as their exact source text so nothing rounds through float64.

Package ynode spells yaml.v3 nodes: the tag a resolved `<<` merge key carries, the constructors for the node kinds a parse produces, and the merge chain the compiler's depth bounds are measured against.