wizard

type AskOptions struct {
	// Stdio overrides the I/O streams; nil uses the real terminal.
	// Tests pass scripted streams via survey/v2's WithStdio.
	Stdio *terminal.Stdio
}

type InputDiff struct {
	// Carry are values that exist in both packages with a compatible
	// type and a recorded prior value. They flow through to the new
	// inputs.yaml verbatim.
	Carry map[string]any
	// AdoptedDefaults are inputs new in this version that have a
	// declared default. The default is silently used.
	AdoptedDefaults map[string]any
	// NewRequired are inputs new in this version that are required and
	// have no default. They must be answered (interactive prompt or
	// fail-fast in non-interactive mode).
	NewRequired []api.Input
	// Dropped are prior keys whose input was removed in the new
	// package. Operator does not need to do anything; the value is
	// silently omitted from the new inputs.yaml.
	Dropped []string
	// TypeChanged are inputs whose declared Type differs between old
	// and new. The operator must re-answer because coercion may
	// silently misinterpret the value.
	TypeChanged []api.Input
}

type PriorSource string

type PriorState struct {
	Selection *api.Selection
	Inputs    *api.Inputs
	Facts     *api.Facts
	// PriorPackage is the installer.yaml that produced this state —
	// recovered either from the embedded installer-record (ConfigHub
	// source) or from the work-dir's package/installer.yaml (local
	// source). Used by upgrade's schema-diff to compare new vs old.
	PriorPackage *api.Package
	// Upload is the recorded upload destination, if any.
	Upload *api.Upload
}

type RawAnswers struct {
	// Inputs is the raw map from --input k=v, where v is a string.
	Inputs map[string]string
	// SelectedComponents is the list from --select (raw user picks; closure
	// happens later in the solver).
	SelectedComponents []string
	// BaseName is the chosen base from --base; "" means use the package default.
	BaseName string
	// Namespace is the Kubernetes namespace from --namespace. Persisted to
	// inputs.yaml and exposed to function-chain templates as {{ .Namespace }}.
	Namespace string
	// ImageOverrides is the map from --set-image name=ref. Merged with
	// PriorImageOverrides (this run's overrides win on conflict) and
	// persisted into Inputs.Spec.ImageOverrides so render can apply
	// `kustomize edit set image` for each entry before kustomize build.
	ImageOverrides map[string]string
	// PriorImageOverrides is the carry-forward set from a prior
	// install's Inputs.Spec.ImageOverrides. Wizard merges it under
	// ImageOverrides (this run wins on conflict) so an upgrade
	// without --set-image preserves the operator's existing
	// overrides.
	PriorImageOverrides map[string]string
}

type Result struct {
	Selection *api.Selection
	Inputs    *api.Inputs
	Facts     *api.Facts
}

type SelectionDiff struct {
	// Components is the resolved new selection — the operator's
	// effective component list under the new package's component
	// graph.
	Components []string
	// PreservedFromPrior is a copy of Components for callers that want
	// to know how many entries were carried forward from the prior
	// selection.
	PreservedFromPrior []string
	// AdoptedNewDefaults names components new in this version that
	// were silently selected because the prior install used the
	// default preset and the components are flagged default: true.
	AdoptedNewDefaults []string
	// RemovedFromPrior names prior selections whose component no
	// longer exists in the new package. Silently dropped.
	RemovedFromPrior []string
	// DefaultPresetDetected is true when prior matches old package's
	// `default` preset exactly — the upgrade re-runs the default
	// preset against the new package rather than carrying the
	// (possibly stale) component list verbatim.
	DefaultPresetDetected bool
}