application

type App interface {
	Execute(args []string)
	Log() *slogd.Logger
	Name() string
	Pid() int
}

type Builder struct {
	Title   string
	Version Version
	Command *command
	Signals *Signals
	Mux     *sync.Mutex
}

type Component interface {
	Name() string
	Type() reflect.Type
	WithPreRunE(f func(ctx Context) error) Component
	WithPostRunE(f func(ctx Context) error) Component
	PreRunE() func(ctx Context) error
	PostRunE() func(ctx Context) error
	Get() any
	Set(v any)
}

type Context struct {
	Ctx context.Context
	App *app
}

type Flag struct {
	Name     string
	Short    string // single-char alias (e.g. "p")
	Usage    string
	Default  any // must match FlagType
	Type     FlagType
	Allowed  []any // optional list of allowed values; checked when Validate is nil
	Required bool
	Validate func(any) error // optional per-flag value validator
}

type FlagType int

type Signal struct {
	Signal  os.Signal
	Handler func(ctx Context, cancel context.CancelFunc, sig os.Signal) error
}

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

type Version struct {
	Full       string
	Branch     string
	Tag        string
	Commit     string
	CommitDate string
	BuildDate  string
	Major      string
	Minor      string
	Patch      string
	Prerelease string
}