engine

type Capture struct {
	// Coordinate is the exact inventory location rendered by FFmpeg.
	Coordinate graph.Coordinate
	// Discovery records whether navigation or structural inventory found the screen.
	Discovery graph.Discovery
	// Image is the owned composed menu frame.
	Image *image.NRGBA
	// HasOverlay reports that decoded SPU state was composited.
	HasOverlay bool
	// HasHighlight reports that a selected-button highlight was composited.
	HasHighlight bool
}

type Options struct {
	// Traversal controls deterministic graph discovery and selection limits.
	Traversal graph.Options
	// Scan controls bounded NAV and subpicture reads for each menu cell.
	Scan nav.CellScanOptions
	// ProcessTimeout bounds each FFmpeg probe and frame decode; zero uses the default.
	ProcessTimeout time.Duration
	// Deinterlace enables frame deinterlacing before SPU composition.
	Deinterlace bool
	// Capability reuses a prior successful FFmpeg probe when non-nil.
	Capability *render.Capability
	// Progress receives synchronous path-free phase and counter updates.
	Progress func(Progress)
	// Logger receives optional path-free discovery and rendering diagnostics.
	Logger graph.Logger
}

type Progress struct {
	// Phase is discovering or capturing.
	Phase string
	// Inventoried is the number of structural menu programs.
	Inventoried int
	// VisitedStates is the number of distinct VM states evaluated.
	VisitedStates int
	// VisitedButtons is the number of button commands evaluated.
	VisitedButtons int
	// Captured is the number of composed non-black frames retained.
	Captured int
	// Warnings is the number of distinct coverage warnings.
	Warnings int
}

type Result struct {
	// EngineVersion identifies the engine implementation that produced the result.
	EngineVersion string
	// Capability is the successful path-free FFmpeg probe result.
	Capability render.Capability
	// Captures contains composed non-black menu frames in selection order.
	Captures []Capture
	// Inventoried is the number of structural menu programs.
	Inventoried int
	// Selected is the number of distinct screens selected for rendering.
	Selected int
	// VisitedStates is the number of distinct VM states evaluated.
	VisitedStates int
	// VisitedButtons is the number of button commands evaluated.
	VisitedButtons int
	// Complete reports that every selected screen rendered without coverage warnings.
	Complete bool
	// Partial reports incomplete discovery, live-state, or rendering coverage.
	Partial bool
	// Truncated reports that the traversal item limit excluded eligible screens.
	Truncated bool
	// Warnings contains deduplicated path-free coverage diagnostics.
	Warnings []graph.Warning
}