cmd

type AmbiguousStopError struct {
	Query string
	Stops []api.Stop
}

type AuthCmd struct {
	SetKey AuthSetKeyCmd `cmd:"" name:"set-key" help:"Store API key in keyring"`
	Status AuthStatusCmd `cmd:"" help:"Show authentication status"`
	Remove AuthRemoveCmd `cmd:"" help:"Remove stored API key"`
}

type AuthRemoveCmd struct{}

type AuthSetKeyCmd struct {
	Stdin bool `help:"Read API key from stdin (for scripts)"`
}

type AuthStatusCmd struct{}

type CLI struct {
	RootFlags `embed:""`

	Version    kong.VersionFlag `help:"Print version and exit"`
	VersionCmd VersionCmd       `cmd:"" name:"version" help:"Print version"`
	Auth       AuthCmd          `cmd:"" help:"Manage API key"`
	Config     ConfigCmd        `cmd:"" help:"Manage configuration"`
	Stops      StopsCmd         `cmd:"" help:"Search and view stops"`
	Lines      LinesCmd         `cmd:"" help:"Search and view lines"`
	Departures DeparturesCmd    `cmd:"" help:"Show realtime departures"`
	Info       InfoCmd          `cmd:"" help:"Show CLI and API info"`
	Completion CompletionCmd    `cmd:"" help:"Generate shell completions"`
}

type CompletionBashCmd struct{}

type CompletionCmd struct {
	Bash CompletionBashCmd `cmd:"" help:"Generate bash completions"`
	Zsh  CompletionZshCmd  `cmd:"" help:"Generate zsh completions"`
	Fish CompletionFishCmd `cmd:"" help:"Generate fish completions"`
}

type CompletionFishCmd struct{}

type CompletionZshCmd struct{}

type ConfigCmd struct {
	SetFavorite    ConfigSetFavoriteCmd    `cmd:"" name:"set-favorite" help:"Set a favorite stop alias"`
	RemoveFavorite ConfigRemoveFavoriteCmd `cmd:"" name:"remove-favorite" help:"Remove a favorite stop alias"`
	ListFavorites  ConfigListFavoritesCmd  `cmd:"" name:"list-favorites" help:"List all favorite stops"`
}

type ConfigListFavoritesCmd struct{}

type ConfigRemoveFavoriteCmd struct {
	Name string `arg:"" required:"" help:"Alias name to remove"`
}

type ConfigSetFavoriteCmd struct {
	Name string `arg:"" required:"" help:"Alias name (e.g., home, work)"`
	Stop string `arg:"" required:"" help:"Stop number (6-digit)"`
}

type DeparturesCmd struct {
	Stop  string `arg:"" required:"" help:"Stop (number, name, or @favorite)"`
	Watch bool   `help:"Auto-refresh every 30 seconds" short:"w"`
	Count int    `help:"Maximum number of departures" default:"10" short:"n"`
	Line  string `help:"Filter by line number" short:"l"`
}

type ExitError struct {
	Code int
	Err  error
}

type InfoCmd struct{}

type LinesCmd struct {
	Search LinesSearchCmd `cmd:"" help:"Search lines by number or name"`
	Get    LinesGetCmd    `cmd:"" help:"Get line details"`
}

type LinesGetCmd struct {
	Entity int `arg:"" required:"" help:"Entity number (1-5)"`
	Line   int `arg:"" required:"" help:"Line number"`
}

type LinesSearchCmd struct {
	Query string `arg:"" required:"" help:"Line number or name"`
}

type RootFlags struct {
	JSON    bool `help:"Output JSON to stdout"`
	Plain   bool `help:"Output plain TSV (for scripting)"`
	NoColor bool `help:"Disable colors" env:"NO_COLOR"`
}

type StopsCmd struct {
	Search StopsSearchCmd `cmd:"" help:"Search stops by name"`
	Get    StopsGetCmd    `cmd:"" help:"Get stop details by number"`
}

type StopsGetCmd struct {
	Number string `arg:"" required:"" help:"6-digit stop number (e.g., 200552)"`
}

type StopsSearchCmd struct {
	Query string `arg:"" required:"" help:"Search query (stop name)"`
}

type VersionCmd struct{}