visual

type AdvancedComparisonResult struct {
	PixelComparison      *ComparisonResult
	StructuralSimilarity float64
	HistogramSimilarity  float64
	OverallScore         float64
	Passed               bool
}

type BaselineComparison struct {
	TestName1            string
	TestName2            string
	Identical            bool
	DifferencePercentage float64
	Metadata1            *BaselineMetadata
	Metadata2            *BaselineMetadata
}

type BaselineInfo struct {
	TestName     string
	ImageFile    string
	ImageSize    int64
	ImageModTime time.Time
	Metadata     *BaselineMetadata
}

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

type BaselineMetadata struct {
	// Version is the baseline version
	Version string
	// CreatedAt is when the baseline was created
	CreatedAt time.Time
	// UpdatedAt is when the baseline was last updated
	UpdatedAt time.Time
	// URL is the URL that was captured
	URL string
	// ViewportSize is the viewport size used
	ViewportSize ViewportSize
	// DeviceEmulation is the device emulation used
	DeviceEmulation *DeviceEmulation
	// BrowserInfo contains browser information
	BrowserInfo BrowserInfo
	// TestName is the name of the test
	TestName string
	// TestSuite is the test suite name
	TestSuite string
	// Environment is the testing environment
	Environment string
	// Branch is the git branch
	Branch string
	// Commit is the git commit hash
	Commit string
	// Tags are additional tags
	Tags []string
	// Notes are additional notes
	Notes string
	// ChecksumMD5 is the MD5 checksum of the image
	ChecksumMD5 string
	// ChecksumSHA256 is the SHA256 checksum of the image
	ChecksumSHA256 string
	// FileSize is the size of the image file
	FileSize int64
	// ImageDimensions contains image dimensions
	ImageDimensions ImageDimensions
}

type BaselineValidation struct {
	TestName        string
	Valid           bool
	Issues          []string
	ImageDimensions *ImageDimensions
	Metadata        *BaselineMetadata
}

type BrowserInfo struct {
	Name    string
	Version string
	Major   int
	Minor   int
	Patch   int
	Build   string
}

type CLIConfig struct {
	BaselineDir         string
	ActualDir           string
	DiffDir             string
	ReportDir           string
	ConfigFile          string
	Verbose             bool
	OutputFormat        string
	Headless            bool
	UseProfile          bool
	ProfileName         string
	ChromePath          string
	Timeout             time.Duration
	Retries             int
	Threshold           float64
	IgnoreAntialiasing  bool
	EnableFuzzyMatching bool
	FuzzyThreshold      float64
	MaxDiffPixels       int
	Quality             int
	Format              string
	FullPage            bool
	ViewportWidth       int
	ViewportHeight      int
	DeviceScaleFactor   float64
	EmulateDevice       string
	WaitForFonts        bool
	WaitForImages       bool
	WaitForAnimations   bool
	HideCursor          bool
	HideScrollbars      bool
	CustomCSS           string
	ExcludeSelectors    []string
	MaskSelectors       []string
	MaskColor           string
}

type ComparisonResult struct {
	// Passed indicates if the comparison passed
	Passed bool
	// DiffPixels is the number of different pixels
	DiffPixels int
	// TotalPixels is the total number of pixels
	TotalPixels int
	// DifferencePercentage is the percentage of different pixels
	DifferencePercentage float64
	// DiffImage is the difference image
	DiffImage image.Image
	// MatchingScore is the overall matching score (0-1)
	MatchingScore float64
	// Regions are the different regions
	Regions []DiffRegion
	// Metadata contains comparison metadata
	Metadata map[string]interface{}
}

type DeviceEmulation struct {
	Name              string
	ViewportSize      ViewportSize
	DeviceScaleFactor float64
	IsMobile          bool
	HasTouch          bool
	UserAgent         string
	ScreenWidth       int
	ScreenHeight      int
	ScreenOrientation string
}

type DiffRegion struct {
	X      int
	Y      int
	Width  int
	Height int
	Score  float64
}

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

type ImageDimensions struct {
	Width  int
	Height int
}

type ResponsiveTest struct {
	Name     string
	URL      string
	Setup    func(ctx context.Context, page *browser.Page) error
	Action   func(ctx context.Context, page *browser.Page) error
	Cleanup  func(ctx context.Context, page *browser.Page) error
	Tags     []string
	Metadata map[string]interface{}
}

type ResponsiveTestConfig struct {
	// BaseConfig is the base visual test configuration
	BaseConfig *VisualTestConfig
	// Viewports are the viewports to test
	Viewports []ViewportSize
	// Devices are the devices to emulate
	Devices []string
	// OrientationTest enables orientation testing
	OrientationTest bool
	// PixelDensities are the pixel densities to test
	PixelDensities []float64
	// BreakpointTest enables breakpoint testing
	BreakpointTest bool
	// Breakpoints are custom breakpoints to test
	Breakpoints []int
}

type ResponsiveTestResult struct {
	TestName  string
	URL       string
	Results   map[string]*TestResult // keyed by viewport/device name
	Summary   ResponsiveTestSummary
	Timestamp time.Time
	Duration  time.Duration
	Passed    bool
	Config    *ResponsiveTestConfig
	Metadata  map[string]interface{}
}

type ResponsiveTestSuiteResult struct {
	SuiteName string
	Results   []*ResponsiveTestResult
	Summary   ResponsiveTestSuiteSummary
	Timestamp time.Time
	Duration  time.Duration
	Passed    bool
	Config    *ResponsiveTestConfig
	Metadata  map[string]interface{}
}

type ResponsiveTestSuiteSummary struct {
	TotalTests      int
	PassedTests     int
	FailedTests     int
	PassRate        float64
	TotalDuration   time.Duration
	AverageDuration time.Duration
}

type ResponsiveTestSummary struct {
	TotalViewports    int
	PassedViewports   int
	FailedViewports   int
	WorstViewport     string
	WorstDifference   float64
	BestViewport      string
	BestDifference    float64
	AverageDifference float64
}

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

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

type ScreenshotOptions struct {
	// FullPage captures the entire page
	FullPage bool
	// Selector captures only the specified element
	Selector string
	// ViewportWidth sets the viewport width
	ViewportWidth int
	// ViewportHeight sets the viewport height
	ViewportHeight int
	// Quality is the image quality (1-100)
	Quality int
	// Format is the image format (png, jpg, webp)
	Format string
	// HideCursor hides the mouse cursor
	HideCursor bool
	// HideScrollbars hides scrollbars
	HideScrollbars bool
	// WaitForFonts waits for fonts to load
	WaitForFonts bool
	// WaitForImages waits for images to load
	WaitForImages bool
	// WaitForAnimations waits for animations to complete
	WaitForAnimations bool
	// AnimationWaitTime is the time to wait for animations
	AnimationWaitTime time.Duration
	// StabilityWaitTime is the time to wait for page stability
	StabilityWaitTime time.Duration
	// DeviceScaleFactor sets the device scale factor
	DeviceScaleFactor float64
	// EmulateDevice emulates a specific device
	EmulateDevice string
	// ClipToViewport clips the screenshot to the viewport
	ClipToViewport bool
	// OmitBackground omits the background
	OmitBackground bool
	// CustomCSS injects custom CSS before taking screenshot
	CustomCSS string
	// ExcludeSelectors excludes elements from the screenshot
	ExcludeSelectors []string
	// MaskSelectors masks elements in the screenshot
	MaskSelectors []string
	// MaskColor is the color to use for masking
	MaskColor string
}

type TestReport struct {
	// Title is the report title
	Title string
	// SuiteResults are the suite results
	SuiteResults []*TestSuiteResult
	// Summary is the overall summary
	Summary TestSummary
	// GeneratedAt is when the report was generated
	GeneratedAt time.Time
	// Environment is the testing environment
	Environment string
	// Config is the configuration used
	Config *VisualTestConfig
	// Metadata contains additional metadata
	Metadata map[string]interface{}
}

type TestResult struct {
	// TestName is the name of the test
	TestName string
	// TestSuite is the test suite name
	TestSuite string
	// Passed indicates if the test passed
	Passed bool
	// ComparisonResult is the detailed comparison result
	ComparisonResult *ComparisonResult
	// BaselineMetadata is the baseline metadata
	BaselineMetadata *BaselineMetadata
	// ActualScreenshot is the actual screenshot data
	ActualScreenshot []byte
	// BaselineScreenshot is the baseline screenshot data
	BaselineScreenshot []byte
	// DiffScreenshot is the diff screenshot data
	DiffScreenshot []byte
	// Error is any error that occurred
	Error error
	// Duration is how long the test took
	Duration time.Duration
	// Timestamp is when the test was run
	Timestamp time.Time
	// Retries is the number of retries performed
	Retries int
	// Environment is the testing environment
	Environment string
	// URL is the URL that was tested
	URL string
	// Config is the test configuration used
	Config *VisualTestConfig
	// ScreenshotOptions are the options used for screenshot
	ScreenshotOptions *ScreenshotOptions
	// Metadata contains additional metadata
	Metadata map[string]interface{}
}

type TestSuiteResult struct {
	// SuiteName is the name of the test suite
	SuiteName string
	// Results are the individual test results
	Results []*TestResult
	// Passed indicates if all tests passed
	Passed bool
	// Duration is the total duration
	Duration time.Duration
	// Timestamp is when the suite was run
	Timestamp time.Time
	// Environment is the testing environment
	Environment string
	// Summary contains summary statistics
	Summary TestSummary
	// Config is the suite configuration
	Config *VisualTestConfig
	// Metadata contains additional metadata
	Metadata map[string]interface{}
}

type TestSummary struct {
	// TotalTests is the total number of tests
	TotalTests int
	// PassedTests is the number of passed tests
	PassedTests int
	// FailedTests is the number of failed tests
	FailedTests int
	// SkippedTests is the number of skipped tests
	SkippedTests int
	// PassRate is the pass rate (0-1)
	PassRate float64
	// TotalDuration is the total duration
	TotalDuration time.Duration
	// AverageDuration is the average duration per test
	AverageDuration time.Duration
}

type ViewportFailure struct {
	Viewport     string
	FailureCount int
	FailureRate  float64
}

type ViewportSize struct {
	Width  int
	Height int
	Name   string
}

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

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

type VisualTest struct {
	// Name is the test name
	Name string
	// URL is the URL to test
	URL string
	// Setup is a function to set up the test (optional)
	Setup func(ctx context.Context, page *browser.Page) error
	// Action is a function to perform actions before screenshot (optional)
	Action func(ctx context.Context, page *browser.Page) error
	// Cleanup is a function to clean up after the test (optional)
	Cleanup func(ctx context.Context, page *browser.Page) error
	// Options are the screenshot options
	Options *ScreenshotOptions
	// Viewport is the viewport size
	Viewport *ViewportSize
	// DeviceEmulation is the device emulation
	DeviceEmulation *DeviceEmulation
	// Timeout is the test timeout
	Timeout time.Duration
	// Retries is the number of retries
	Retries int
	// Skip indicates if the test should be skipped
	Skip bool
	// SkipReason is the reason for skipping
	SkipReason string
	// Tags are test tags
	Tags []string
	// Metadata contains additional metadata
	Metadata map[string]interface{}
}

type VisualTestConfig struct {
	// BaselineDir is the directory where baseline images are stored
	BaselineDir string
	// ActualDir is the directory where actual screenshots are stored
	ActualDir string
	// DiffDir is the directory where diff images are stored
	DiffDir string
	// Threshold is the pixel difference threshold (0-1)
	Threshold float64
	// IgnoreAntialiasing ignores antialiasing differences
	IgnoreAntialiasing bool
	// EnableFuzzyMatching enables fuzzy matching for tolerance
	EnableFuzzyMatching bool
	// FuzzyThreshold is the fuzzy matching threshold (0-1)
	FuzzyThreshold float64
	// MaxDiffPixels is the maximum allowed different pixels
	MaxDiffPixels int
	// Quality is the screenshot quality (1-100)
	Quality int
	// Format is the screenshot format (png, jpg, webp)
	Format string
	// RetryCount is the number of retries for flaky tests
	RetryCount int
	// RetryDelay is the delay between retries
	RetryDelay time.Duration
}

type VisualTester interface {
	// CaptureScreenshot captures a screenshot with the given options
	CaptureScreenshot(ctx context.Context, page *browser.Page, opts *ScreenshotOptions) ([]byte, error)

	// CompareImages compares two images and returns the result
	CompareImages(baseline, actual image.Image, config *VisualTestConfig) (*ComparisonResult, error)

	// RunVisualTest runs a visual test
	RunVisualTest(ctx context.Context, testName string, page *browser.Page, config *VisualTestConfig, opts *ScreenshotOptions) (*TestResult, error)

	// RunTestSuite runs a test suite
	RunTestSuite(ctx context.Context, suiteName string, tests []VisualTest, config *VisualTestConfig) (*TestSuiteResult, error)

	// SaveBaseline saves a baseline image
	SaveBaseline(testName string, screenshot []byte, metadata *BaselineMetadata, config *VisualTestConfig) error

	// LoadBaseline loads a baseline image
	LoadBaseline(testName string, config *VisualTestConfig) ([]byte, *BaselineMetadata, error)

	// GetBaselineMetadata gets metadata for a baseline
	GetBaselineMetadata(testName string, config *VisualTestConfig) (*BaselineMetadata, error)

	// UpdateBaseline updates a baseline image
	UpdateBaseline(testName string, screenshot []byte, metadata *BaselineMetadata, config *VisualTestConfig) error

	// DeleteBaseline deletes a baseline image
	DeleteBaseline(testName string, config *VisualTestConfig) error

	// ListBaselines lists all baselines
	ListBaselines(config *VisualTestConfig) ([]string, error)

	// GenerateReport generates a visual test report
	GenerateReport(results []*TestResult, config *VisualTestConfig) (*TestReport, error)
}