runtime

type Event string

type File struct {
	Name     string
	MIMEType string
	Contents []byte
}

type Runtime interface {
	// Name returns the runtime identifier used in reports.
	Name() string
	// ResetSession applies a declared state boundary before a scenario runs.
	ResetSession(requirement SessionRequirement) error

	// OpenRoute opens an application route without rebooting warm runtimes.
	OpenRoute(route string) error
	// ClickControl activates a named or selector-backed control.
	ClickControl(control string) error
	// DoubleClickContent opens visible content by name.
	DoubleClickContent(content string) error
	// Type enters a value into a named or selector-backed field.
	Type(field string, value string) error
	// UploadFile supplies an in-memory file to the runtime upload control.
	UploadFile(target string, file File) error
	// MoveContent moves one visible content row into another.
	MoveContent(source string, target string) error
	// DeleteSpace deletes the currently open Space and waits for completion.
	DeleteSpace() error

	// ExpectVisible waits until visible content appears.
	ExpectVisible(content string) error
	// ExpectAbsent waits until visible content disappears.
	ExpectAbsent(content string) error
	// ExpectRoute verifies the current route contains the expected path.
	ExpectRoute(route string) error
	// WaitForEvent waits for a named runtime readiness transition.
	WaitForEvent(event Event) error

	// OpenSecondTab opens another browser tab at a route in the same install.
	OpenSecondTab(route string) (Tab, error)
	// BackgroundTab moves a tab out of foreground focus when supported.
	BackgroundTab(tab Tab) error
	// ReloadPage reloads the active page without replacing the browser install.
	ReloadPage() error
	// RestartWorkerHost restarts the runtime worker host when supported.
	RestartWorkerHost() error
}

type SessionRequirement string

type SkipError struct {
	Control string
	Reason  string
}

type Tab interface {
	// ID returns the runtime-specific tab identifier.
	ID() string
}