1- // Package submitview implements the interactive two-step TUI used by
2- // `gh stack submit` to create a stack of pull requests. Step 1 selects which
3- // branches without a PR should become PRs; Step 2 is a two-panel editor for
4- // drafting each PR's title, description, and draft state before a single
5- // batch submit.
1+ // Package submitview implements the interactive single-screen TUI used by
2+ // `gh stack submit` to create a stack of pull requests. A left-hand timeline
3+ // lists the stack and lets the user choose which branches without a PR should
4+ // become PRs; the right-hand editor drafts each PR's title, description, and
5+ // ready/draft state before a single batch submit.
66//
77// The package builds on the shared Charm components in internal/tui/shared and
88// reuses the branch display data loaded by internal/tui/stackview. The submit
@@ -15,13 +15,13 @@ import (
1515)
1616
1717// BranchState classifies a branch by the status of its pull request. The state
18- // determines whether a branch is selectable in Step 1, editable in Step 2 , and
19- // which badge color it renders with.
18+ // determines whether a branch is selectable and editable in the TUI , and which
19+ // badge color it renders with.
2020type BranchState int
2121
2222const (
2323 // StateNew is a branch with no PR yet. It is the only interactive state:
24- // selectable in Step 1 (default on) and editable in Step 2 .
24+ // selectable (default on) and editable.
2525 StateNew BranchState = iota
2626 // StateOpen is a branch with an open (non-draft) PR. Locked, shown for context.
2727 StateOpen
@@ -36,12 +36,12 @@ const (
3636 StateClosed
3737)
3838
39- // Selectable reports whether a branch in this state can be toggled in Step 1.
40- // Only NEW branches are selectable.
39+ // Selectable reports whether a branch in this state can be toggled for
40+ // inclusion. Only NEW branches are selectable.
4141func (s BranchState ) Selectable () bool { return s == StateNew }
4242
43- // Editable reports whether a branch in this state opens the editor in Step 2.
44- // Only NEW branches are editable.
43+ // Editable reports whether a branch in this state opens the editor. Only NEW
44+ // branches are editable.
4545func (s BranchState ) Editable () bool { return s == StateNew }
4646
4747// Locked reports whether a branch is shown for context only (open, draft,
0 commit comments