refactor: add terminal output and forms package (#1124)

- `internal/terminal`: streams and the prompting policy, interactive forms (issue, PR, review, merge, milestone), editor / pager / browser launching, JSON and `--jq` output.
- An aligned table renderer and a record renderer for human output; both strip control and escape characters from server-supplied text so titles and bodies cannot inject terminal sequences.

Reviewed-on: https://gitea.com/gitea/tea/pulls/1124
Reviewed-by: TheFox0x7 <95654+thefox0x7@noreply.gitea.com>

internal/terminal/review_form.go

@@ -0,0 +1,94 @@
+// Copyright 2026 The Gitea Authors. All rights reserved.
+// SPDX-License-Identifier: MIT
+
+package terminal
+
+import (
+	"context"
+	"fmt"
+	"strings"
+
+	"charm.land/huh/v2"
+)
+
+// ReviewCommentDraft is an inline comment collected during interactive review.
+type ReviewCommentDraft struct {
+	Path, Body       string
+	OldLine, NewLine int64
+}
+
+// ReviewFormChoices supplies callbacks for interactive pull review.
+type ReviewFormChoices struct {
+	// ReviewDiff, when non-nil, runs after the user opts into annotating the diff.
+	ReviewDiff func(context.Context) ([]ReviewCommentDraft, error)
+	EditBody   BodyEditor
+}
+
+// ReviewFormValues holds interactively collected review fields.
+type ReviewFormValues struct {
+	Event    string
+	Body     string
+	Comments []ReviewCommentDraft
+	Draft    Draft
+}
+
+// ReviewForm collects interactive pull review input.
+type ReviewForm interface {
+	CreateReview(context.Context, ReviewFormChoices) (ReviewFormValues, error)
+}
+
+// CreateReview runs the interactive review form on stderr.
+func (p *FormPrompter) CreateReview(ctx context.Context, choices ReviewFormChoices) (ReviewFormValues, error) {
+	var comments []ReviewCommentDraft
+	if choices.ReviewDiff != nil {
+		reviewDiff := true
+		if err := p.runForm(ctx, huh.NewForm(huh.NewGroup(
+			huh.NewConfirm().Title("Review / comment the diff?").Value(&reviewDiff),
+		))); err != nil {
+			return ReviewFormValues{}, err
+		}
+		if reviewDiff {
+			parsed, err := choices.ReviewDiff(ctx)
+			if err != nil {
+				return ReviewFormValues{}, fmt.Errorf("diff review failed: %w", err)
+			}
+			comments = append(comments, parsed...)
+			fmt.Fprintf(p.Streams.ErrOut, "Found %d code comments in your review\n", len(comments))
+		}
+	}
+
+	event := "COMMENT"
+	if err := p.runForm(ctx, huh.NewForm(huh.NewGroup(
+		huh.NewSelect[string]().Title("Your assessment:").Options(
+			huh.NewOption("comment", "COMMENT"),
+			huh.NewOption("request changes", "REQUEST_CHANGES"),
+			huh.NewOption("approve", "APPROVED"),
+		).Value(&event),
+	))); err != nil {
+		return ReviewFormValues{}, err
+	}
+
+	body := ""
+	values := ReviewFormValues{Event: event, Comments: comments}
+	required := (event == "COMMENT" && len(comments) == 0) || event == "REQUEST_CHANGES"
+	if choices.EditBody != nil {
+		var err error
+		if body, values.Draft, err = editBody(ctx, choices.EditBody, ""); err != nil {
+			return values, err
+		}
+	} else {
+		field := huh.NewText().Title("Concluding comment(markdown):").Value(&body)
+		if required {
+			field = field.Title("Concluding comment(markdown) (required):").Validate(huh.ValidateNotEmpty())
+		}
+		if err := p.runForm(ctx, huh.NewForm(huh.NewGroup(field))); err != nil {
+			return ReviewFormValues{}, err
+		}
+	}
+	body = strings.TrimSpace(body)
+	if required && body == "" {
+		return values, fmt.Errorf("concluding comment cannot be empty")
+	}
+	values.Body = body
+	return values, nil
+}