Representation of items and prefixItems in Schema

[travisnewhouse]

For an array type, there are two properties that specify the schemas of array items:

• items is a JSON Schema (either object or boolean).
• prefixItems is an array of JSON Schema correspond to elements in an array instance.

High-level Schema has Items field with type []*SchemaProxy, but it does not store any of the values of prefixItems. Low-level Schema is similar.

I think confusion would arise if prefixItems are stored in Items and items schema stored as the last element of Items. There would be no way to disambiguate between items being present or absent. So, one recommendation is to define field Items of type *SchemaProxy and field PrefixItems of type []*SchemaProxy.

[daveshanley]

Ah! yes, this is a gap in OpenAPI 3.1 support - where we jumped to full JSON schema support. I will add in prefixItems to low and high level models at earliest convenience.

[daveshanley]

prefixItems has been added to the schema model and should be ready to use. I'm close to a 0.1.2 release/tag, so it will be easily pullable then, however the code is in main if you want top of tree access.

[daveshanley]

because there are some very minor breaking changes, this was added to v0.2.0, and now prefixItems is available. Thank you for helping me make this a better tool, Travis.