spec

type Additional struct {
	Mode   AdditionalMode
	Schema *Schema
}

type AdditionalMode int

type Bound struct {
	Value     json.Number
	Exclusive bool
}

type Callback struct {
	Name       string
	Operations []*Operation
	Ref        *ComponentRef
}

type ComponentRef struct {
	Pointer string
	Name    string
}

type Components struct {
	Schemas         []Named[*Schema]
	Responses       []Named[*Response]
	Parameters      []Named[*Parameter]
	RequestBodies   []Named[*RequestBody]
	Headers         []Named[*Header]
	SecuritySchemes []*SecurityScheme
}

type Discriminator struct {
	Property string
	Mapping  []Mapping
	Default  *Ref
}

type Document struct {
	Version    Version
	Info       Info
	Servers    []Server
	Operations []*Operation
	Webhooks   []*Operation
	Components Components
	Security   []SecurityRequirement
	Extensions []Extension
}

type Encoding struct {
	Name          string
	ContentType   string
	Headers       []*Header
	Style         string
	Explode       *bool
	AllowReserved bool
}

type Extension struct {
	Name  string
	Value Value
}

type Field struct {
	Name  string
	Value Value
}

type Header struct {
	Name        string
	Description string
	Required    bool
	Deprecated  bool
	Style       string
	Explode     bool
	Schema      *Schema
	Contents    []*MediaType
	Extensions  []Extension
	Ref         *ComponentRef
	Origin      Origin
}

type Info struct {
	Title       string
	Summary     string
	Description string
	Version     string
	Extensions  []Extension
}

type Limits struct {
	Minimum       *Bound
	Maximum       *Bound
	MultipleOf    *json.Number
	MinLength     *int64
	MaxLength     *int64
	MinItems      *int64
	MaxItems      *int64
	MinProperties *int64
	MaxProperties *int64
	UniqueItems   bool
}

type Mapping struct {
	Value string
	Ref   *Ref
}

type MediaType struct {
	Name       string
	Schema     *Schema
	ItemSchema *Schema
	Encodings  []*Encoding
	Extensions []Extension
	Origin     Origin
}

type Named[T any] struct {
	Name  string
	Value T
}

type OAuthFlow struct {
	Kind             string
	AuthorizationURL string
	TokenURL         string
	RefreshURL       string
	Scopes           []Scope
}

type Operation struct {
	ID          string
	IsIDDerived bool
	Method      string
	Path        string
	IsWebhook   bool
	Summary     string
	Description string
	Deprecated  bool
	Tags        []string
	// Path-level params come first; an operation param with the same in and name replaces one.
	Params    []*Parameter
	Body      *RequestBody
	Responses []*Response
	Callbacks []*Callback
	// Security is the effective list: the operation's own when it sets one, else the document's.
	Security   []SecurityRequirement
	Servers    []Server
	Extensions []Extension
	Origin     Origin
}

type Origin struct {
	Pointer string
	File    string
	Line    int
	Col     int
}

type Parameter struct {
	Name            string
	In              string
	Description     string
	Required        bool
	Deprecated      bool
	AllowEmptyValue bool
	Style           string
	Explode         bool
	AllowReserved   bool
	Schema          *Schema
	Contents        []*MediaType
	Extensions      []Extension
	Ref             *ComponentRef
	Origin          Origin
}

type Property struct {
	Name     string
	Schema   *Schema
	Required bool
}

type Ref struct {
	Pointer string
	Name    string
	Target  *Schema
}

type RequestBody struct {
	Description string
	Required    bool
	Contents    []*MediaType
	Extensions  []Extension
	Ref         *ComponentRef
	Origin      Origin
}

type RequiredScheme struct {
	Name   string
	Scopes []string
}

type Response struct {
	Status      string
	Description string
	Headers     []*Header
	Contents    []*MediaType
	Extensions  []Extension
	Ref         *ComponentRef
	Origin      Origin
}

type Schema struct {
	Ref                  *Ref
	Types                TypeSet
	Nullable             bool
	Format               string
	Title                string
	Description          string
	Pattern              string
	ContentEncoding      string
	ContentMediaType     string
	Required             []string
	Properties           []*Property
	AdditionalProperties Additional
	PropertyNames        *Schema
	Items                *Schema
	PrefixItems          []*Schema
	AllOf                []*Schema
	OneOf                []*Schema
	AnyOf                []*Schema
	Not                  *Schema
	If                   *Schema
	Then                 *Schema
	Else                 *Schema
	Discriminator        *Discriminator
	Enum                 []Value
	Const                *Value
	Default              *Value
	Examples             []Value
	Limits               Limits
	ReadOnly             bool
	WriteOnly            bool
	Deprecated           bool
	Extensions           []Extension
	Origin               Origin
}

type Scope struct {
	Name        string
	Description string
}

type SecurityRequirement struct {
	Schemes []RequiredScheme
}

type SecurityScheme struct {
	Name              string
	Type              string
	Description       string
	In                string
	ParamName         string
	Scheme            string
	BearerFormat      string
	OpenIDConnectURL  string
	OAuth2MetadataURL string
	Flows             []OAuthFlow
	Deprecated        bool
	Extensions        []Extension
	Origin            Origin
}

type Server struct {
	URL         string
	Name        string
	Description string
	Variables   []ServerVariable
}

type ServerVariable struct {
	Name        string
	Default     string
	Description string
	Enum        []string
}

type TypeSet uint8

type Value struct {
	Kind   ValueKind
	Str    string
	Num    json.Number
	Bool   bool
	Items  []Value
	Fields []Field
}

type ValueKind int

type Version int