visualtest

type AxeImpact string

type AxeNode struct {
	HTML           string   `json:"html"`
	Target         []string `json:"target"`
	FailureSummary string   `json:"failureSummary"`
}

type AxeResults struct {
	Violations []AxeViolation `json:"violations"`
}

type AxeRuleID string

type AxeViolation struct {
	ID      AxeRuleID `json:"id"`
	Impact  AxeImpact `json:"impact"`
	Help    string    `json:"help"`
	HelpURL string    `json:"helpUrl"`
	Nodes   []AxeNode `json:"nodes"`
	Tags    []string  `json:"tags"`
}

type DemoServer struct {

	// Log accumulates the server's combined stdout+stderr so tests (and the
	// CI smoke) can assert absence of 500 responses. Mutex-guarded: the exec
	// copier goroutine writes concurrently with test reads (the data race
	// TestDemoKanbanHTTPContracts caught under -race on 2026-09-17).
	Log syncBuffer
	// contains filtered or unexported fields
}

type InteractionState int

type Options struct {
	// Dark renders with the .dark class on <html> (the library's dark-mode
	// strategy). nil or false renders light mode; use Bool(true) for dark.
	// The pointer (not bare bool) lets callers distinguish "unset" from
	// "explicitly light" in test metadata.
	Dark *bool
	// RTL sets dir="rtl" on <html> to test logical-property mirroring.
	// nil or false renders LTR; use Bool(true) for RTL.
	RTL *bool
	// Viewport sets the emulated window size. Defaults to 1280x800
	// (ViewportDesktop). See ViewportMobile / ViewportTablet presets.
	Viewport Viewport
	// MaxMismatch is the largest fraction of mismatched pixels (0–1) that
	// still passes. Defaults to 0.001 (0.1%). Anti-aliasing noise is filtered
	// out by pixelmatch; a real regression blows past this.
	MaxMismatch float64
	// Threshold is the pixelmatch perceptual color-distance threshold (0–1).
	// Pixels whose YIQ distance is below it count as identical. Default 0.1;
	// raise it to tolerate more rendering noise, lower it for stricter checks.
	Threshold float64
	// State applies an interaction (hover/focus/click) to #tc-root before capture.
	State InteractionState
	// FullViewport captures the full browser viewport instead of a tightly
	// cropped #tc-root element. Required for components whose open state
	// renders in the top layer (Popover API menus, <dialog>), because that
	// content is painted outside #tc-root's bounding box and would be cropped
	// by an element screenshot.
	FullViewport bool
	// WaitSelector, when set, is waited for (chromedp.WaitVisible) AFTER the
	// interaction state is applied and BEFORE capture. Use it with StateClick
	// to wait for an overlay menu to appear, e.g. WaitSelector: "[popover]".
	WaitSelector string
	// ClickSelector overrides the StateClick heuristic (first interactive
	// descendant) with an explicit target INSIDE #tc-root, e.g.
	// "[data-tc-carousel-next]". Use when the first interactive element is
	// not the one that produces the state under test.
	ClickSelector string
	// WaitExpr, when set, is polled (every 100ms, up to 8s) after the
	// interaction state and must evaluate to truthy before capture. Use for
	// states that settle asynchronously without a DOM visibility change,
	// e.g. a scroll-snap carousel whose smooth scroll converges:
	//
	//	WaitExpr: `document.querySelector('[data-tc-carousel-track]').scrollLeft > 50`
	WaitExpr string
}

type Viewport struct {
	Width  int
	Height int
}