core

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

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.
	EnvKey       string           // Custom environment variable (overrides derived key).
	HideEnv      bool             // If true, hide ENV key from help.
	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).
	HideAllowed  bool             // Hide allowed values from help.
	OneOfGroup   *OneOfGroupGroup // OneOfGroup group membership.
	AllOrNone    *AllOrNoneGroup  // AllOrNone group membership.
	Requires     []string         // Names of flags this flag requires
	HideRequires bool             // Hide “(Requires)” in help.
}

type DuplicatePerIDError struct {
	Field string // dynamic field name, e.g. "timeout"
	ID    string // instance id, e.g. "alpha"
}

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 OncePerIDToggler interface {
	EnableOncePerID()
}

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

type Registry interface {
	RegisterFlag(name string, bf *BaseFlag)
	GetOneOfGroup(name string) *OneOfGroupGroup
	OneOfGroups() []*OneOfGroupGroup
	DefaultDelimiter() string
	GetAllOrNoneGroup(name string) *AllOrNoneGroup
}

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
}