cli

type Candidate struct {
	Value       string `json:"value"`
	Description string `json:"description,omitempty"`
}

type Completion struct {
	Candidates []Candidate
	Directive  cobra.ShellCompDirective
}

type Engine struct {
	// Client connects through the CLI's own -H handling.
	Client func() (*api.Client, error)
}

type Options struct {
	// Version is what --version and `wctr version` print (default "dev").
	Version string
	// DefaultHost is the -H default (default api.DefaultHost()).
	DefaultHost string
	// Client connects to a host; nil means api.NewClient.
	Client func(host string) (*api.Client, error)
	// LookupEnv resolves `-e KEY` (default os.LookupEnv).
	LookupEnv func(string) (string, bool)
	// PullCandidates, when set, adds pullable images to the completion of
	// pull and run (the playground's mirror catalogue).
	PullCandidates func(context.Context) []cobra.Completion
	// RunArgs, when set, completes the arguments after the image of run
	// (the playground knows its lab image's subcommands).
	RunArgs func(image string, args []string) []cobra.Completion
	// NoCompletionCommand removes cobra's `completion` command (scripts
	// for a shell the host does not have, as in the browser).
	NoCompletionCommand bool
	// Extra adds commands from other modules (`wctr build`, `wctr
	// compose`) to the tree. Each is made once per RootCmd and receives a
	// way to reach the engine selected by -H: Engine returns its HTTP
	// client and base URL (or an *api.Client through Client).
	Extra []func(Engine) *cobra.Command
}