schema

type ParamField struct {
	// Name is the wire name, taken from the location tag's value.
	Name string
	// In is the parameter location: "query", "header", or "cookie".
	In string
	// Required is the value of the field's required tag (default
	// false — query, header, and cookie parameters are optional by
	// convention).
	Required bool
	// Description is the field's doc/description tag.
	Description string
	// Schema is the parameter's schema, with constraint tags applied.
	Schema *Schema
}

type Reflector struct {

	// NoAutoDescriptions suppresses the "Generated from Go type ..."
	// fallback descriptions on named components. User-supplied doc:
	// tags are unaffected.
	NoAutoDescriptions bool
	// contains filtered or unexported fields
}

type Schema struct {
	// Type is the JSON Schema type: "object", "array", "string", "number",
	// "integer", "boolean", or "null". Empty means "no type constraint"
	// (matches anything). For interfaces, Type is left empty.
	Type string
	// Format is the JSON Schema format hint: "int32", "int64", "float",
	// "double", "date-time", "date", "time", "byte", "binary", "email", etc.
	Format string
	// Description is a human-readable description of this value.
	Description string
	// Properties maps JSON field name to its Schema. Only for Type=="object".
	Properties map[string]*Schema
	// Required is the list of property names that must be present.
	Required []string
	// Items is the element schema. Only for Type=="array".
	Items *Schema
	// AdditionalProperties constrains map values. Only for Type=="object"
	// when used as a map type.
	AdditionalProperties *Schema
	// Ref is a $ref pointer into the components.schemas section. When set,
	// the emitter emits a $ref object (wrapped when Nullable, Description,
	// or Example are also set) and ignores the structural fields.
	Ref string
	// Enum, when non-empty, restricts the value to a fixed set.
	Enum []any
	// Default is the default value, if any.
	Default any
	// Example is an example value, if any.
	Example any
	// Minimum and Maximum bound numeric values (inclusive). They are
	// kept as json.Number so the document shows the literal the user
	// wrote ("10" stays an integer, "0.5" a decimal). Empty means
	// unset.
	Minimum json.Number
	Maximum json.Number
	// ExclusiveMinimum and ExclusiveMaximum bound numeric values
	// exclusively. The emitters render them per version: a numeric
	// keyword in 3.1/3.2, the 3.0 boolean form (minimum +
	// exclusiveMinimum: true) in 3.0. Mutually exclusive with
	// Minimum/Maximum on the same bound. Empty means unset.
	ExclusiveMinimum json.Number
	ExclusiveMaximum json.Number
	// MinLength and MaxLength bound string lengths. Nil means unset.
	MinLength *uint64
	MaxLength *uint64
	// Pattern is an ECMA-262 regular expression strings must match.
	Pattern string
	// MinItems and MaxItems bound array lengths. Nil means unset.
	MinItems *uint64
	MaxItems *uint64
	// UniqueItems requires array elements to be unique.
	UniqueItems bool
	// Nullable is true when the value may be null (Go: a pointer or interface).
	// In OpenAPI 3.0 this is emitted as `"nullable": true`. In 3.1/3.2 it is
	// expressed by adding "null" to the type array.
	Nullable bool
	// Extensions is a map of x-stdocs-* and similar extension fields. The
	// keys are emitted as-is (e.g. "x-stdocs-type"); values must be
	// JSON-serializable.
	Extensions map[string]any
}