validator

type FileLocation struct {
	// FilePath is the absolute path to the configuration file
	FilePath string `json:"filePath" yaml:"filePath"`

	// Line is the line number where the error occurred (1-based)
	Line int `json:"line" yaml:"line"`

	// Column is the column number where the error occurred (1-based, optional)
	Column int `json:"column" yaml:"column"`
}

type MockValidator[T any] struct {
	mock.Mock
}

type MockValidator_Expecter[T any] struct {
	// contains filtered or unexported fields
}

type MockValidator_Validate_Call[T any] struct {
	*mock.Call
}

type ValidationError struct {
	// Field is the specific field path that failed validation (e.g., "spec.distribution", "metadata.name")
	Field string `json:"field" yaml:"field"`

	// Message is a human-readable description of the validation error
	Message string `json:"message" yaml:"message"`

	// CurrentValue is the actual value that was found in the configuration
	CurrentValue any `json:"currentValue" yaml:"currentValue"`

	// ExpectedValue is the expected value or constraint that was violated
	ExpectedValue any `json:"expectedValue" yaml:"expectedValue"`

	// FixSuggestion provides actionable guidance on how to fix the error
	FixSuggestion string `json:"fixSuggestion" yaml:"fixSuggestion"`

	// Location provides file and line information where the error occurred
	Location FileLocation `json:"location" yaml:"location"`
}

type ValidationResult struct {
	// Valid indicates overall validation status (true if no errors)
	Valid bool `json:"valid" yaml:"valid"`

	// Errors contains all validation errors found
	Errors []ValidationError `json:"errors" yaml:"errors"`

	// Warnings contains validation warnings (non-blocking)
	Warnings []ValidationError `json:"warnings" yaml:"warnings"`

	// ConfigFile is the path to the configuration file that was validated
	ConfigFile string `json:"configFile" yaml:"configFile"`
}

type Validator[T any] interface {
	// Validate performs validation on an already parsed configuration struct.
	// This method focuses on semantic validation of the configuration content.
	//
	// Parameters:
	//   - config: Already parsed configuration struct of type T
	//
	// Returns:
	//   - ValidationResult containing status and any errors found
	//
	// Contract Requirements:
	//   - MUST validate semantic correctness of configuration
	//   - MUST check field constraints and dependencies
	//   - MUST return actionable error messages
	//   - MUST be idempotent (same input = same output)
	//   - MUST handle nil or malformed structs gracefully
	Validate(config T) *ValidationResult
}