mergeview

type MergeStatus struct {
	// Status is the current merge state.
	Status Status
	// Message is the human-readable status or failure reason.
	Message string
	// UUID identifies an in-flight merge request, used for polling.
	UUID string
	// SHA is the resulting merge commit on success.
	SHA string
}

type Model struct {
	// contains filtered or unexported fields
}

type Options struct {
	// PRs are the selectable (open, mergeable) pull requests ordered bottom to
	// top of the stack.
	PRs []PRItem
	// StackNumber is the repo-scoped stack number, shown in the header.
	StackNumber int
	// BaseRef is the branch the stack merges into (for display).
	BaseRef string
	// RepoSlug is owner/repo, for display.
	RepoSlug string
	// AllowedMethods are the repo's enabled merge methods in display order
	// (subset of "merge", "squash", "rebase").
	AllowedMethods []string
	// DefaultMethod is the method preselected in the picker (the viewer's
	// last-used method).
	DefaultMethod string
	// UsesMergeQueue reports that the stack's base branch merges through a merge
	// queue. When set, the wizard skips the merge-method step (the queue picks
	// the method), labels the summary "via merge queue", and enqueues instead of
	// merging directly.
	UsesMergeQueue bool
	// PreselectTopIndex, when >= 0, preselects PRs[0..PreselectTopIndex] and
	// skips the PR-selection step (PR-number mode).
	PreselectTopIndex int
	// Submit and Poll perform the async merge; injected by the command.
	Submit SubmitFunc
	Poll   PollFunc
	// PollInterval is the delay between status polls. Defaults to one second.
	PollInterval time.Duration
}

type Outcome struct {
	// Cancelled reports the user quit before the merge was submitted.
	Cancelled bool
	// Submitted reports a merge request was sent to GitHub.
	Submitted bool
	// Merged reports the merge completed successfully.
	Merged bool
	// Enqueued reports the stack was added to the base branch's merge queue
	// (it will merge once the queue processes it).
	Enqueued bool
	// Failed reports the merge was attempted but did not complete (conflict,
	// rule failure, or not mergeable).
	Failed bool
	// WatchStopped reports the user stopped watching an in-flight merge (ctrl+c
	// during progress); the merge continues on GitHub.
	WatchStopped bool
	// Message is the final status or failure message.
	Message string
	// TargetPR is the topmost selected PR (the merge high-water mark).
	TargetPR int
	// Method is the chosen merge method.
	Method string
	// MergedPRs are the PR numbers included in the merge.
	MergedPRs []int
	// SHA is the resulting merge commit on success.
	SHA string
	// Err is a transport/API error encountered during submit or polling.
	Err error
}

type PRItem struct {
	Number int
	Title  string
	Branch string
}

type PollFunc func(targetPR int, uuid string) (MergeStatus, error)

type Status string

type Step int

type SubmitFunc func(targetPR int, method string) (MergeStatus, error)