core

type BaseFlag struct {
	Name             string                 // Long name (e.g. "verbose").
	Short            string                 // Short alias (single letter, e.g. "v").
	Usage            string                 // Brief description shown in help.
	Value            Value                  // Underlying value handler (scalar, slice, or dynamic).
	Hidden           bool                   // If true, omit from help.
	DisableEnv       bool                   // If true, disallow ENV lookup.
	HideEnv          bool                   // If true, hide ENV key from help.
	EnvKey           string                 // Custom environment variable (overrides derived key).
	Deprecated       string                 // If non‐empty, show deprecation notice.
	Required         bool                   // Mark flag as required.
	HideRequired     bool                   // Hide “(Required)” in help.
	Placeholder      string                 // Placeholder for the value (e.g. "FILE").
	Allowed          []string               // Allowed string values (help only).
	MutualGroup      *MutualExlusiveGroup   // Mutual exclusion group membership.
	RequiredTogether *RequiredTogetherGroup // Mutual exclusion group membership.
}

type DynamicItemValues interface {
	ValuesAny() map[string]any
}

type DynamicValue interface {
	Set(id, val string) error
	FieldName() string
	GetAny(id string) (any, bool)
}

type GroupItem struct {
	Value DynamicValue
	Flag  *BaseFlag
}

type Incrementable interface {
	Value
	Increment() error
}

type MutualExlusiveGroup struct {
	Name           string                   // Identifier for this group.
	Flags          []*BaseFlag              // Member flags.
	RequiredGroups []*RequiredTogetherGroup // Optional grouped sets
	// contains filtered or unexported fields
}

type Registry interface {
	RegisterFlag(name string, bf *BaseFlag)
	GetMutualGroup(name string) *MutualExlusiveGroup
	MutualGroups() []*MutualExlusiveGroup
	DefaultDelimiter() string
	GetRequireTogetherGroup(name string) *RequiredTogetherGroup
}

type RequiredTogetherGroup struct {
	Name  string      // Identifier for this group.
	Flags []*BaseFlag // Member flags.
	// contains filtered or unexported fields
}

type SliceMarker interface {
	IsSlice()
}

type StrictBool interface {
	IsStrictBool() bool
}

type Value interface {
	Set(string) error // parse from string
	Get() any         // retrieve stored value
	Changed() bool    // was flag explicitly set?
	Default() string  // default value as string
}