cliparser

type Def struct {
	// ConfigKey is the stable overlay key (e.g. "webserver.port").
	ConfigKey string
	// Longs are long flag names without leading dashes (e.g. "webserver-port" or "port").
	Longs []string
	// Shorts are optional single-letter short names without leading dashes (e.g. "p").
	Shorts []string
	// Help is optional usage text.
	Help string
	// Env is an optional exact environment variable override. Empty derives the
	// name from the first long option; "-" disables environment loading.
	Env string
	// Kind selects value parsing behavior.
	Kind Kind
	// Enum is the allowlist this flag accepts, already split and trimmed at
	// generation time. A usage renderer lists the choices; the value check
	// itself lives in the generated apply code, not here.
	Enum []string
	// UsesOptOverride is true when names came from an opt-style override.
	UsesOptOverride bool
}

type FieldMeta struct {
	// Prefix is the Bind prefix / table name (e.g. "webserver").
	Prefix string
	// Key is the relative field key under the prefix (e.g. "port" or "tls.enabled").
	Key string
	// Opt is an optional override of the form "long" or "long,short" (no dashes).
	// When set, only those names are registered; default --prefix-key is suppressed.
	Opt string
	// Help is optional CLI help text.
	Help string
	// Env is an optional exact environment variable override, or "-" to disable
	// environment loading for this field.
	Env string
	// Kind defaults to KindString when zero value is left as KindString.
	Kind Kind
	// Enum is the field's allowlist, already split and trimmed, for usage text.
	Enum []string
}

type Kind int

type Result struct {
	// Values maps stable config keys to a single string (last write wins for KindString/KindBool).
	Values map[string]string
	// Multi maps stable config keys to accumulated values for KindArray flags.
	Multi map[string][]string
	// Rest is non-flag arguments after flags (or after "--").
	Rest []string
}