envbuilder

type Chunk struct {
	Prompt      UserPrompt
	PromptIndex int
	Lines       string
	LineIndex   int
}

type DotenvChunks []Chunk

type EnvironmentValidationError struct {
	Results []ValidationResult
}

type MissingPromptLineIndex struct {
	LineIndex int
}

type MissingPrompts map[string]MissingPromptLineIndex

type ParsedYaml map[string][]UserPrompt

type PromptInstance struct {
	Prompt      UserPrompt
	PromptIndex int
	HelpLines   []string
}

type PromptInstances map[string]PromptInstance

type PromptOption struct {
	Blank    bool
	Checked  bool
	Name     string `yaml:"name"`
	Value    string `yaml:"value,omitempty"`
	Requires string `yaml:"requires,omitempty"`
}

type PromptType string

type UserPrompt struct {
	Section string
	Root    bool
	// Active indicates if this prompt should be processed (based on conditional logic).
	Active bool
	// Commented indicates if the variable should be commented out in the .env file. This
	// can be used for variables that the user may want to set but are not required.
	Commented bool
	// Value is the current value for this prompt (from .env, environment, or user input).
	Value string
	// Hidden indicates if this prompt should never be shown to users (e.g., core variables).
	Hidden bool

	// Env is the environment variable name to set (e.g., "DATABASE_URL").
	Env string `yaml:"env"`
	// Key is an alternative identifier when Env is not set (written as comment).
	Key string `yaml:"key"`
	// Type is the prompt type: "string" (default) or "secret_string" (masked input).
	Type PromptType `yaml:"type"`
	// Multiple allows selecting multiple options (checkbox-style) when Options is set.
	Multiple bool `yaml:"multiple"`
	// Options provides a list of choices for selection-style prompts.
	Options []PromptOption `yaml:"options,omitempty"`
	// Default is the initial value for this prompt. Prompts with defaults are
	// skipped during the wizard unless the value differs or AlwaysPrompt is set.
	Default string `yaml:"default,omitempty"`
	// Help is the description text shown to users when prompting for input.
	Help string `yaml:"help"`
	// Optional allows the prompt to be skipped without providing a value.
	Optional bool `yaml:"optional,omitempty"`
	// Generate auto-generates a cryptographic random value for secret_string types.
	Generate bool `yaml:"generate,omitempty"`
	// AlwaysPrompt forces the prompt to be shown even when a default value is set.
	// Use this for prompts where users should consciously confirm or change the default.
	// This does not affect prompts with options that have "requires" fields -
	// those prompts are always shown regardless of defaults. This also does not
	// affect prompts that are required due to conditional logic, or hidden prompts.
	AlwaysPrompt bool `yaml:"always_prompt,omitempty"`
}

type ValidationResult struct {
	Field   string // The environment variable name or key
	Value   string // The actual value (empty if not set)
	Valid   bool   // Whether the variable is valid
	Message string // Error message if invalid, or success message if valid
	Help    string // Optional help text describing the variable
}

type Variable struct {
	Name        string
	Value       string
	Description string
	Secret      bool
	Commented   bool
}

type Variables []Variable