split

type ActionResult struct {
	OriginalBranch string
	NewBranches    []string
	Style          Style
}

type CommitMessageContext struct {
	// Files being extracted to the new branch
	Files []string
	// Direction of the split (above = child, below = parent)
	Direction Direction
	// CurrentBranch is the name of the branch being split
	CurrentBranch string
	// OriginalCommitMessage is the full message of the first commit on the branch
	// (title + body). Used as the basis for the split commit message.
	OriginalCommitMessage string
}

type Direction string

type DirectionContext struct {
	Engine        engine.BranchReader
	CurrentBranch string
	ParentBranch  string
	Children      []string
}

type Handler interface {
	// Start is called at the beginning of split
	Start(branchName string, style Style)

	// OnStep is called for each step in the split process
	OnStep(step Step, status handler.StepStatus, message string)

	// OnBranchCreated is called when a new branch is created during split
	OnBranchCreated(branchName string)

	// Complete is called when split finishes
	Complete(result ActionResult)

	// Cleanup restores terminal state (may be no-op)
	Cleanup()

	// IsInteractive returns true if the handler supports interactive prompts
	IsInteractive() bool
}

type InteractiveHandler interface {
	Handler

	// IsInteractive returns true if this handler supports interactive prompts.
	// Non-interactive handlers return false, and their prompt methods will return errors.
	IsInteractive() bool

	// PromptSplitType asks the user to choose between available split types.
	// availableTypes contains the choices with their availability status.
	// Returns the selected Style or an error if canceled.
	PromptSplitType(availableTypes []TypeChoice) (Style, error)

	// PromptDirection asks the user where to place the new branch.
	// Returns the selected Direction or an error if canceled.
	PromptDirection(ctx DirectionContext) (Direction, error)

	// ShowHunkSummary displays a summary of the remaining changes before staging.
	// This is informational only, no user input required.
	ShowHunkSummary(diff string)

	// PromptCommitMessage asks the user to enter or edit a commit message.
	// defaultMsg is the suggested default (e.g., from original commit).
	// Returns the final message or an error if canceled.
	PromptCommitMessage(defaultMsg string) (string, error)

	// PromptCommitMessageWithContext asks the user to enter a commit message
	// with full context about the split operation displayed.
	// The context includes files being extracted, direction, and current branch.
	// Returns the commit message or an error if canceled.
	PromptCommitMessageWithContext(ctx CommitMessageContext) (string, error)

	// PromptBranchName asks the user to enter a branch name.
	// defaultName is the auto-generated suggestion.
	// sessionNames contains names already used in this split session.
	// allBranchNames contains all existing branch names in the repo (for O(1) lookup).
	// originalBranchName is the name of the branch being split (allowed to reuse).
	// Returns the final name or an error if canceled.
	PromptBranchName(defaultName string, sessionNames []string, allBranchNames *engine.BranchSet, originalBranchName string) (string, error)

	// PromptContinueOrCancel asks user whether to continue after no changes were staged.
	// Returns true to try again, false to cancel.
	PromptContinueOrCancel() (bool, error)

	// PromptEditCommitMessage asks whether the user wants to edit the commit message.
	// Returns true if user wants to edit.
	PromptEditCommitMessage() (bool, error)

	// PromptSelectHunks displays the hunk selector TUI and returns selected hunks.
	// Returns the hunks that the user selected, or an error if canceled.
	PromptSelectHunks(hunks []git.Hunk) ([]git.Hunk, error)
}

type NullHandler struct {
	handler.NullBase
	handler.NullProgress[Step]
}

type Options struct {
	Style         Style
	Direction     Direction
	Pathspecs     []string
	BranchPattern config.BranchPattern
	// AsSibling creates split branches as siblings on the same parent instead
	// of creating a linear chain. When true:
	// - StyleFile: Creates sibling branch, original branch unchanged
	// - StyleCommit: All split branches are siblings on the same parent
	// - StyleHunk: All split branches are siblings on the same parent
	AsSibling bool
	// Name specifies a custom name for the split branch (file split only).
	// If empty, auto-generates as "{original}_split".
	Name string
	// Message specifies the commit message for the split operation.
	// Only applies to StyleFile (other styles use existing commit messages).
	Message string
	// UseWizard enables the new wizard-based interactive flow.
	// When true, the wizard will guide through type/direction selection.
	UseWizard bool
	// HunkSelector specifies which hunk selection method to use ("tui" or "git").
	// Only applies to StyleHunk. When "git", uses git add -p instead of the TUI selector.
	HunkSelector string
	// PatchFile specifies a patch file for non-interactive hunk selection.
	// If set, hunks in the patch are staged directly without prompting.
	// Use "-" to read from stdin.
	PatchFile string
	// DryRun shows what would happen without executing the split.
	// When true, the split logic runs but no branches are created or modified.
	DryRun bool
}

type Result struct {
	BranchNames  []string // From oldest to newest
	BranchPoints []int    // Commit indices (0 = HEAD, 1 = HEAD~1, etc.)
}

type Step string

type Style string

type TypeChoice struct {
	Style       Style
	Label       string
	Description string
	Available   bool // false if the option is not available (e.g., commit split for single-commit branch)
}

type WizardOptions struct {
	// Style is pre-selected split style (empty = prompt user)
	Style Style
	// Direction is pre-selected direction (empty = prompt user)
	Direction Direction
	// BranchName is a pre-selected branch name (empty = prompt or auto-generate)
	BranchName string
	// HunkSelector specifies which hunk selection method to use ("tui" or "git")
	HunkSelector string
}