forms

type Field struct {
	Key      string
	Label    string
	Kind     FieldKind
	Options  []string
	Required bool
	Disabled bool
	// Help is an optional dimmed hint rendered under the field when focused.
	Help string
	// contains filtered or unexported fields
}

type FieldError struct {
	Field   string
	Message string
}

type FieldKind int

type Form struct {
	Title    string
	Subtitle string

	// OnChange is called after any field value changes, so the form can
	// recompute derived fields (labels, options, enabled/disabled). It may be
	// nil for static forms.
	OnChange func(f *Form, changedKey string)
	// Submit validates and persists the form. It returns the result value on
	// success, or a *FieldError / plain error on failure. It is required.
	Submit func(f *Form) (string, error)
	// Interrupt, if set, is consulted for every key before normal handling. It
	// may return a navigation Intent to yield to the host (e.g. open a nested
	// form) without editing or completing the form.
	Interrupt func(f *Form, key tea.KeyMsg) (Intent, bool)
	// contains filtered or unexported fields
}

type Intent struct {
	Name  string
	Value string
}

type ProfileBackend interface {
	// StoreOptions returns the selectable store names.
	StoreOptions() []string
	// ProviderForSourceType returns the auth provider a source type requires,
	// or "" when the source needs no auth.
	ProviderForSourceType(sourceType string) string
	// AuthOptions returns the auth refs available for a provider.
	AuthOptions(provider string) []string
	// SourceParts splits an existing source URI into its (type, value) pair.
	SourceParts(sourceURI string) (sourceType, value string)
	// SourceDetailLabel returns the label for the source detail field.
	SourceDetailLabel(sourceType string) string
	// SourceDetailRequired reports whether the source detail is mandatory.
	SourceDetailRequired(sourceType string) bool
	// SourceExample returns an example hint for the source detail field.
	SourceExample(sourceType string) string
	// ComposeSource builds and validates a source URI from type and value.
	ComposeSource(sourceType, value string) (string, error)
	// ValidateNewName validates a candidate new profile name.
	ValidateNewName(name string) error
	// ProfileExists reports whether a profile name is already taken.
	ProfileExists(name string) bool
	// SaveProfile persists the profile.
	SaveProfile(name, sourceURI, storeRef, authRef string, editing bool) error
}

type SecretBackend interface {
	// StorageOptions returns the selectable storage schemes: "env" plus the
	// available writable backend schemes (keychain, secret-service, …).
	StorageOptions() []string
	// DefaultRef returns a suggested reference for a writable backend scheme.
	DefaultRef(scheme, storeName, account string) string
	// ParseRef reports a reference's scheme, and for env refs the variable
	// name; ok is false when the reference does not parse.
	ParseRef(ref string) (scheme, envName string, ok bool)
	// ValidateRef validates a reference's format.
	ValidateRef(ref string) error
	// StoreSecret stores value under the reference in its backend.
	StoreSecret(ref, value string) error
}

type SecretFieldInfo struct {
	// Label names the secret in prose, e.g. "S3 access key".
	Label string
	// DefaultEnvName is the suggested environment variable name.
	DefaultEnvName string
	// DefaultAccount is the account/key hint passed to writable backends.
	DefaultAccount string
}

type StoreBackend interface {
	// StoreDetailLabel returns the label for the primary value field.
	StoreDetailLabel(storeType string) string
	// StoreExample returns an example hint for the primary value field.
	StoreExample(storeType string) string
	// ComposeStore builds and validates a store URI from type and value.
	ComposeStore(storeType, value string) (string, error)
	// ValidateStoreName validates a candidate new store name.
	ValidateStoreName(name string) error
	// StoreExists reports whether a store name is already taken.
	StoreExists(name string) bool
	// ValidateSecretRef validates a non-empty secret reference's format.
	ValidateSecretRef(ref string) error
	// SaveStore persists the store from the collected field values.
	SaveStore(name string, values map[string]string, editing bool) error
}