steam

type AppInfo struct {
	Name       string
	InstallDir string
	AppID      int
}

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

type LaunchConfig struct {
	Executable string // Relative executable path (e.g., "game.exe")
	Arguments  string // Launch arguments
	Type       string // Launch type ("default", "none", "option1", etc.)
	OSList     string // Target OS ("windows", "linux", "macos")
	WorkingDir string // Relative working directory
}

type Options struct {
	// FallbackPath is used if Steam directory detection fails.
	// Linux examples: "/home/deck/.steam/steam", "/usr/games/steam"
	// Windows example: "C:\\Program Files (x86)\\Steam"
	FallbackPath string

	// ExtraPaths are additional paths to check for Steam installation.
	// Only used on Linux; ignored on Windows.
	ExtraPaths []string

	// UseXdgOpen uses xdg-open for launching (desktop-friendly).
	// When false, uses direct `steam` command (console/Game Mode friendly).
	// Only used on Linux; ignored on Windows.
	UseXdgOpen bool

	// CheckFlatpak enables checking for Flatpak Steam installation.
	// Only used on Linux; ignored on Windows.
	CheckFlatpak bool
}

type SteamClient interface {
	// FindSteamDir locates the Steam installation directory.
	// Returns the path to the Steam root directory or the fallback path.
	FindSteamDir(cfg *config.Instance) string

	// IsSteamInstalled checks if Steam is installed by verifying the Steam directory exists.
	// Uses FindSteamDir to locate the directory, respecting config overrides.
	IsSteamInstalled(cfg *config.Instance) bool

	// Launch launches a Steam game by its virtual path.
	// Path format: "steam://[id]/[name]" or "steam://rungameid/[id]"
	// Returns nil for fire-and-forget launches (Steam handles the process).
	// The opts parameter is optional and may be nil.
	Launch(cfg *config.Instance, path string, opts *platforms.LaunchOptions) (*os.Process, error)

	// ScanApps scans Steam library for installed official apps.
	// steamAppsDir should point to the steamapps directory (e.g., ~/.steam/steam/steamapps).
	ScanApps(steamAppsDir string) ([]platforms.ScanResult, error)

	// ScanShortcuts scans Steam for non-Steam games (user-added shortcuts).
	// steamDir should point to the Steam root directory.
	ScanShortcuts(steamDir string) ([]platforms.ScanResult, error)
}