schema

type DiscriminatorSchema struct {
	// PropertyName is the name of the property that holds the type tag.
	PropertyName string `json:",omitempty"`
	// Mapping is an optional explicit tag-value → $ref map.
	Mapping map[string]string `json:",omitempty"`
}

type Property struct {
	Name   string
	Schema Schema
}

type Schema struct {
	Type        string     `json:",omitempty"`
	Title       string     `json:",omitempty"`
	Description string     `json:",omitempty"`
	Format      string     `json:",omitempty"`
	Example     any        `json:",omitempty"`
	Properties  []Property `json:",omitempty"`
	Required    []string   `json:",omitempty"`
	Enum        []any      `json:",omitempty"`
	OneOf       []Schema   `json:",omitempty"`
	Items       *Schema    `json:",omitempty"`

	// Nullable marks the value as accepting null in addition to its type.
	// Renders as "nullable: true" in OpenAPI 3.0 / AsyncAPI.
	Nullable bool `json:",omitempty"`

	// AdditionalProperties controls whether undeclared properties are allowed.
	// nil = unset (spec default), false = no additional properties, true = any allowed.
	AdditionalProperties *bool `json:",omitempty"`

	// AdditionalPropertiesSchema constrains the type of additional properties.
	// When set, takes precedence over AdditionalProperties and renders as a schema object.
	// Used by StringMap to express map[string]V where V has a specific schema.
	AdditionalPropertiesSchema *Schema `json:",omitempty"`

	// Discriminator describes the polymorphism tag for TaggedUnion schemas.
	Discriminator *DiscriminatorSchema `json:",omitempty"`

	// Numeric constraints.
	Minimum          *float64 `json:",omitempty"`
	Maximum          *float64 `json:",omitempty"`
	ExclusiveMinimum bool     `json:",omitempty"`
	ExclusiveMaximum bool     `json:",omitempty"`

	// String constraints.
	MinLength *int   `json:",omitempty"`
	MaxLength *int   `json:",omitempty"`
	Pattern   string `json:",omitempty"`

	// Deprecated marks this schema as deprecated in generated documentation.
	Deprecated bool `json:",omitempty"`

	// Default is the default value for this schema, used when the field is absent.
	Default any `json:",omitempty"`
}