verification

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

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

type BaselineStorage interface {
	Save(key string, screenshot *Screenshot) error
	Load(key string) (*Screenshot, error)
	Delete(key string) error
	List() ([]string, error)
}

type Check interface {
	// Name returns the check identifier.
	Name() string

	// Level returns the evaluation level.
	Level() EvaluationLevel

	// Run executes the check.
	Run(ctx context.Context, target any) (*CheckResult, error)

	// Weight returns the check's importance (0.0-1.0).
	Weight() float64
}

type CheckOption func(*BaseCheck)

type CheckResult struct {
	Name     string          `json:"name"`
	Level    EvaluationLevel `json:"level"`
	Passed   bool            `json:"passed"`
	Score    float64         `json:"score"` // 0.0-1.0
	Message  string          `json:"message"`
	Details  map[string]any  `json:"details,omitempty"`
	Duration int64           `json:"duration_ms"`
}

type CommonChecks struct{}

type DiffRegion struct {
	X      int    `json:"x"`
	Y      int    `json:"y"`
	Width  int    `json:"width"`
	Height int    `json:"height"`
	Type   string `json:"type"` // "added", "removed", "changed"
}

type EvaluationLevel int

type EvaluationResult struct {
	Passed          bool                        `json:"passed"`
	TotalScore      float64                     `json:"total_score"`
	MaxScore        float64                     `json:"max_score"`
	NormalizedScore float64                     `json:"normalized_score"` // 0.0-1.0
	LevelScores     map[EvaluationLevel]float64 `json:"level_scores"`
	CheckResults    []*CheckResult              `json:"check_results"`
	FailedLevel     *EvaluationLevel            `json:"failed_level,omitempty"`
	Message         string                      `json:"message"`
}

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

type EvaluatorOption func(*Evaluator)

type ImageComparator interface {
	Compare(before, after *Screenshot) (*VisualDiff, error)
	SetThreshold(threshold float64)
}

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

type Region struct {
	X      int `json:"x"`
	Y      int `json:"y"`
	Width  int `json:"width"`
	Height int `json:"height"`
}

type Rubric struct {
	Name        string           `json:"name"`
	Description string           `json:"description"`
	Criteria    []RubricCriteria `json:"criteria"`
	MaxScore    float64          `json:"max_score"`
}

type RubricCriteria struct {
	Name        string       `json:"name"`
	Description string       `json:"description"`
	Weight      float64      `json:"weight"`
	Levels      []ScoreLevel `json:"levels"`
}

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

type RubricResult struct {
	Rubric     string        `json:"rubric"`
	Scores     []RubricScore `json:"scores"`
	TotalScore float64       `json:"total_score"`
	MaxScore   float64       `json:"max_score"`
	Percentage float64       `json:"percentage"`
	Grade      string        `json:"grade"`
}

type RubricScore struct {
	Criterion string  `json:"criterion"`
	Score     float64 `json:"score"`
	Level     string  `json:"level"`
	Feedback  string  `json:"feedback"`
}

type ScoreLevel struct {
	Score       float64 `json:"score"`
	Description string  `json:"description"`
}

type Screenshot struct {
	ID        string `json:"id"`
	Path      string `json:"path,omitempty"`
	Data      []byte `json:"data,omitempty"`
	Format    string `json:"format"` // "png", "jpeg", "webp"
	Width     int    `json:"width"`
	Height    int    `json:"height"`
	Timestamp int64  `json:"timestamp"`
	Hash      string `json:"hash,omitempty"`
}

type ScreenshotCapturer interface {
	Capture(ctx context.Context, target string) (*Screenshot, error)
	CaptureElement(ctx context.Context, selector string) (*Screenshot, error)
	CaptureFullPage(ctx context.Context, url string) (*Screenshot, error)
}

type UIElement struct {
	Type   string `json:"type"` // "button", "input", "text", etc.
	Text   string `json:"text,omitempty"`
	Region Region `json:"region"`
}

type VerificationResult struct {
	Passed   bool            `json:"passed"`
	Before   *Screenshot     `json:"before"`
	After    *Screenshot     `json:"after"`
	Diff     *VisualDiff     `json:"diff,omitempty"`
	Analysis *VisualAnalysis `json:"analysis,omitempty"`
	Message  string          `json:"message"`
}

type VisualAnalysis struct {
	Description string        `json:"description"`
	Elements    []UIElement   `json:"elements,omitempty"`
	Issues      []VisualIssue `json:"issues,omitempty"`
	Score       float64       `json:"score"` // 0.0-1.0
}

type VisualAnalyzer interface {
	Analyze(ctx context.Context, screenshot *Screenshot, prompt string) (*VisualAnalysis, error)
	CompareWithContext(ctx context.Context, before, after *Screenshot, prompt string) (*VisualAnalysis, error)
}

type VisualConfig struct {
	// DiffThreshold is the maximum allowed difference (0.0-1.0).
	DiffThreshold float64

	// IgnoreRegions are areas to exclude from comparison.
	IgnoreRegions []Region

	// CompareMode determines comparison strategy.
	CompareMode string // "pixel", "perceptual", "structural"

	// OutputDir for saving diff images.
	OutputDir string

	// SaveBaselines stores passing screenshots as new baselines.
	SaveBaselines bool
}

type VisualDiff struct {
	Before     *Screenshot  `json:"before"`
	After      *Screenshot  `json:"after"`
	DiffPixels int          `json:"diff_pixels"`
	DiffPct    float64      `json:"diff_pct"`
	Regions    []DiffRegion `json:"regions,omitempty"`
	Threshold  float64      `json:"threshold"`
	Passed     bool         `json:"passed"`
}

type VisualIssue struct {
	Severity    string `json:"severity"` // "error", "warning", "info"
	Type        string `json:"type"`     // "alignment", "contrast", "overflow", etc.
	Description string `json:"description"`
	Region      Region `json:"region,omitempty"`
}

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