schema

type FieldInfo struct {
	// Name is the field name as it appears in JSON/YAML (from json tag)
	Name string `json:"name" yaml:"name"`

	// GoName is the original Go field name
	GoName string `json:"goName" yaml:"goName"`

	// Type is the Go type name
	Type string `json:"type" yaml:"type"`

	// Kind is the reflect.Kind (struct, slice, map, etc.)
	Kind reflect.Kind `json:"kind" yaml:"kind"`

	// Description from the "doc" tag
	Description string `json:"description,omitempty" yaml:"description,omitempty"`

	// Required from the "required" tag
	Required bool `json:"required,omitempty" yaml:"required,omitempty"`

	// Example from the "example" tag
	Example string `json:"example,omitempty" yaml:"example,omitempty"`

	// Pattern from the "pattern" tag (regex)
	Pattern string `json:"pattern,omitempty" yaml:"pattern,omitempty"`

	// PatternDescription from the "patternDescription" tag
	PatternDescription string `json:"patternDescription,omitempty" yaml:"patternDescription,omitempty"`

	// Format from the "format" tag (uri, email, date, etc.)
	Format string `json:"format,omitempty" yaml:"format,omitempty"`

	// MinLength from the "minLength" tag
	MinLength *int `json:"minLength,omitempty" yaml:"minLength,omitempty"`

	// MaxLength from the "maxLength" tag
	MaxLength *int `json:"maxLength,omitempty" yaml:"maxLength,omitempty"`

	// Minimum from the "minimum" tag
	Minimum *float64 `json:"minimum,omitempty" yaml:"minimum,omitempty"`

	// Maximum from the "maximum" tag
	Maximum *float64 `json:"maximum,omitempty" yaml:"maximum,omitempty"`

	// MinItems from the "minItems" tag
	MinItems *int `json:"minItems,omitempty" yaml:"minItems,omitempty"`

	// MaxItems from the "maxItems" tag
	MaxItems *int `json:"maxItems,omitempty" yaml:"maxItems,omitempty"`

	// Default from the "default" tag
	Default string `json:"default,omitempty" yaml:"default,omitempty"`

	// Enum values (if field is an enum type with known values)
	Enum []string `json:"enum,omitempty" yaml:"enum,omitempty"`

	// Deprecated from the "deprecated" tag
	Deprecated bool `json:"deprecated,omitempty" yaml:"deprecated,omitempty"`

	// Omitempty indicates if the field has omitempty in json tag
	Omitempty bool `json:"omitempty,omitempty" yaml:"omitempty,omitempty"`

	// ElemType is the element type for slices/arrays/maps
	ElemType string `json:"elemType,omitempty" yaml:"elemType,omitempty"`

	// ElemKind is the element's reflect.Kind for slices/arrays/maps
	ElemKind reflect.Kind `json:"elemKind,omitempty" yaml:"elemKind,omitempty"`

	// KeyType is the key type for maps
	KeyType string `json:"keyType,omitempty" yaml:"keyType,omitempty"`

	// NestedFields contains fields if this is a struct type
	NestedFields []FieldInfo `json:"nestedFields,omitempty" yaml:"nestedFields,omitempty"`

	// IsPointer indicates if the field is a pointer type
	IsPointer bool `json:"isPointer,omitempty" yaml:"isPointer,omitempty"`

	// IsExported indicates if the field is exported
	IsExported bool `json:"isExported,omitempty" yaml:"isExported,omitempty"`
}

type FormatOptions struct {
	// ShowNestedFields controls whether to expand nested struct fields
	ShowNestedFields bool

	// MaxDepth limits how deep to recurse into nested types
	MaxDepth int

	// ShowValidation controls whether to show validation rules
	ShowValidation bool

	// Compact uses a more compact output format
	Compact bool
}

type Formatter struct {
	// contains filtered or unexported fields
}

type KindDefinition struct {
	// Name is the kind name used in CLI (e.g., "provider", "solution")
	Name string

	// Aliases are alternative names (e.g., "providers", "prov")
	Aliases []string

	// Description is a brief explanation of the kind
	Description string

	// TypeInstance is a pointer to the type for reflection
	// Use: (*MyType)(nil)
	TypeInstance any

	// TypeInfo is the cached introspected type information
	TypeInfo *TypeInfo
}

type KindRegistry struct {
	// contains filtered or unexported fields
}

type TypeInfo struct {
	// Name is the type name
	Name string `json:"name" yaml:"name"`

	// Package is the package path
	Package string `json:"package" yaml:"package"`

	// Description from the type's doc comment (not available via reflection)
	Description string `json:"description,omitempty" yaml:"description,omitempty"`

	// Kind is the reflect.Kind
	Kind reflect.Kind `json:"kind" yaml:"kind"`

	// Fields contains information about struct fields (if struct type)
	Fields []FieldInfo `json:"fields,omitempty" yaml:"fields,omitempty"`
}

type Violation struct {
	// Path is the dot-notation location of the violation (e.g., "spec.resolvers.env.resolve.with[0]").
	Path string `json:"path" yaml:"path"`
	// Message is a human-readable description of the violation.
	Message string `json:"message" yaml:"message"`
}