Files
skillshare/internal/ui/pterm.go
T
Willie 84ba16802d feat: add log filtering, improve log UX, and custom dropdown
- Add --cmd, --status, --since, --json flags to CLI log command
- Auto-skip irrelevant log section when --cmd narrows to one file
- Add blank line separator between log entries for readability
- API returns totalAll and commands for smarter frontend filtering
- Custom HandSelect dropdown matching hand-drawn design system
- Empty state distinguishes "no matching entries" from "no entries"
- Update website docs and built-in skill reference with new flags
2026-02-11 03:40:54 +08:00

721 lines
16 KiB
Go

package ui
import (
"fmt"
"os"
"regexp"
"strings"
"time"
"github.com/mattn/go-runewidth"
"github.com/pterm/pterm"
)
// ansiRegex matches ANSI escape sequences
var ansiRegex = regexp.MustCompile(`\x1b\[[0-9;]*m`)
// displayWidth returns the visible width of a string (excluding ANSI codes, handling wide chars)
func displayWidth(s string) int {
// Remove ANSI codes first, then calculate Unicode-aware width
clean := ansiRegex.ReplaceAllString(s, "")
return runewidth.StringWidth(clean)
}
// IsTTY returns true if stdout is a terminal
func IsTTY() bool {
fi, _ := os.Stdout.Stat()
return (fi.Mode() & os.ModeCharDevice) != 0
}
// Box prints content in a styled box
func Box(title string, lines ...string) {
if !IsTTY() {
if title != "" {
fmt.Printf("── %s ──\n", title)
}
for _, line := range lines {
fmt.Println(line)
}
return
}
// Find max display width for consistent box width (excludes ANSI codes)
maxLen := 0
for _, line := range lines {
w := displayWidth(line)
if w > maxLen {
maxLen = w
}
}
// Pad lines to same display width
content := ""
for i, line := range lines {
padded := line
w := displayWidth(line)
if w < maxLen {
padded = line + strings.Repeat(" ", maxLen-w)
}
content += padded
if i < len(lines)-1 {
content += "\n"
}
}
box := pterm.DefaultBox.WithTitle(title)
box.Println(content)
}
// HeaderBox prints command header box
func HeaderBox(command, subtitle string) {
if !IsTTY() {
fmt.Printf("%s\n%s\n", command, subtitle)
return
}
box := pterm.DefaultBox.
WithTitle(pterm.Cyan(command)).
WithTitleTopLeft()
box.Println(subtitle)
}
// Spinner wraps pterm spinner with step tracking
type Spinner struct {
spinner *pterm.SpinnerPrinter
start time.Time
currentStep int
totalSteps int
stepPrefix string
}
// StartSpinner starts a spinner with message
func StartSpinner(message string) *Spinner {
if !IsTTY() {
fmt.Printf("... %s\n", message)
return &Spinner{start: time.Now()}
}
s, _ := pterm.DefaultSpinner.Start(message)
return &Spinner{spinner: s, start: time.Now()}
}
// StartSpinnerWithSteps starts a spinner that shows step progress
func StartSpinnerWithSteps(message string, totalSteps int) *Spinner {
if !IsTTY() {
fmt.Printf("... [1/%d] %s\n", totalSteps, message)
return &Spinner{start: time.Now(), currentStep: 1, totalSteps: totalSteps}
}
stepPrefix := fmt.Sprintf("[1/%d] ", totalSteps)
s, _ := pterm.DefaultSpinner.Start(stepPrefix + message)
return &Spinner{
spinner: s,
start: time.Now(),
currentStep: 1,
totalSteps: totalSteps,
stepPrefix: stepPrefix,
}
}
// Update updates spinner text
func (s *Spinner) Update(message string) {
if s.spinner != nil {
s.spinner.UpdateText(s.stepPrefix + message)
} else {
if s.totalSteps > 0 {
fmt.Printf("... [%d/%d] %s\n", s.currentStep, s.totalSteps, message)
} else {
fmt.Printf("... %s\n", message)
}
}
}
// NextStep advances to next step and updates message
func (s *Spinner) NextStep(message string) {
if s.totalSteps > 0 && s.currentStep < s.totalSteps {
s.currentStep++
s.stepPrefix = fmt.Sprintf("[%d/%d] ", s.currentStep, s.totalSteps)
}
s.Update(message)
}
// Success stops spinner with success
func (s *Spinner) Success(message string) {
elapsed := time.Since(s.start)
msg := fmt.Sprintf("%s (%.1fs)", message, elapsed.Seconds())
if s.spinner != nil {
s.spinner.Success(msg)
} else {
fmt.Printf("✓ %s\n", msg)
}
}
// Fail stops spinner with failure (red)
func (s *Spinner) Fail(message string) {
if s.spinner != nil {
s.spinner.Fail(message)
} else {
fmt.Printf("✗ %s\n", message)
}
}
// Warn stops spinner with warning (yellow)
func (s *Spinner) Warn(message string) {
elapsed := time.Since(s.start)
msg := fmt.Sprintf("%s (%.1fs)", message, elapsed.Seconds())
if s.spinner != nil {
s.spinner.Warning(msg)
} else {
fmt.Printf("! %s\n", msg)
}
}
// Stop stops spinner without message
func (s *Spinner) Stop() {
if s.spinner != nil {
s.spinner.Stop()
}
}
// SuccessMsg prints success message
func SuccessMsg(format string, args ...interface{}) {
msg := fmt.Sprintf(format, args...)
if IsTTY() {
pterm.Success.Println(msg)
} else {
fmt.Printf("✓ %s\n", msg)
}
}
// ErrorMsg prints error message
func ErrorMsg(format string, args ...interface{}) {
msg := fmt.Sprintf(format, args...)
if IsTTY() {
pterm.Error.Println(msg)
} else {
fmt.Printf("✗ %s\n", msg)
}
}
// WarningBox prints warning in a box
func WarningBox(title string, lines ...string) {
if !IsTTY() {
fmt.Printf("! %s\n", title)
for _, line := range lines {
fmt.Printf(" %s\n", line)
}
return
}
// Find max display width for consistent box width (excludes ANSI codes)
maxLen := 0
for _, line := range lines {
w := displayWidth(line)
if w > maxLen {
maxLen = w
}
}
// Pad lines to same display width
content := ""
for i, line := range lines {
padded := line
w := displayWidth(line)
if w < maxLen {
padded = line + strings.Repeat(" ", maxLen-w)
}
content += padded
if i < len(lines)-1 {
content += "\n"
}
}
box := pterm.DefaultBox.
WithTitle(pterm.Yellow(title)).
WithBoxStyle(pterm.NewStyle(pterm.FgYellow))
box.Println(content)
}
// SummaryBox prints a summary box with key-value pairs
func SummaryBox(title string, items map[string]string) {
if !IsTTY() {
fmt.Printf("── %s ──\n", title)
for k, v := range items {
fmt.Printf(" %s: %s\n", k, v)
}
return
}
var lines []string
for k, v := range items {
lines = append(lines, fmt.Sprintf(" %-10s %s", k+":", v))
}
// Find max display width for consistent box width (excludes ANSI codes)
maxLen := 0
for _, line := range lines {
w := displayWidth(line)
if w > maxLen {
maxLen = w
}
}
// Pad lines to same display width
content := ""
for i, line := range lines {
padded := line
w := displayWidth(line)
if w < maxLen {
padded = line + strings.Repeat(" ", maxLen-w)
}
content += padded
if i < len(lines)-1 {
content += "\n"
}
}
box := pterm.DefaultBox.WithTitle(title)
box.Println(content)
}
// ProgressBar wraps pterm progress bar
type ProgressBar struct {
bar *pterm.ProgressbarPrinter
total int
}
// StartProgress starts a progress bar
func StartProgress(title string, total int) *ProgressBar {
if !IsTTY() {
fmt.Printf("%s (0/%d)\n", title, total)
return &ProgressBar{total: total}
}
bar, _ := pterm.DefaultProgressbar.
WithTotal(total).
WithTitle(title).
Start()
return &ProgressBar{bar: bar, total: total}
}
// Increment increments progress
func (p *ProgressBar) Increment() {
if p.bar != nil {
p.bar.Increment()
}
}
// UpdateTitle updates progress bar title
func (p *ProgressBar) UpdateTitle(title string) {
if p.bar != nil {
p.bar.UpdateTitle(title)
} else {
fmt.Printf(" %s\n", title)
}
}
// Stop stops the progress bar
func (p *ProgressBar) Stop() {
if p.bar != nil {
p.bar.Stop()
}
}
// UpdateNotification prints a colorful update notification
func UpdateNotification(currentVersion, latestVersion string) {
if !IsTTY() {
fmt.Printf("\n! Update available: %s -> %s\n", currentVersion, latestVersion)
fmt.Println(" Run 'skillshare upgrade' to update")
return
}
fmt.Println()
// Build content lines
lines := []string{
"",
fmt.Sprintf(" Version: %s -> %s", currentVersion, latestVersion),
"",
" Run: skillshare upgrade",
"",
}
// Find max display width for consistent box width (excludes ANSI codes)
maxLen := 0
for _, line := range lines {
w := displayWidth(line)
if w > maxLen {
maxLen = w
}
}
// Pad lines to same display width
content := ""
for i, line := range lines {
padded := line
w := displayWidth(line)
if w < maxLen {
padded = line + strings.Repeat(" ", maxLen-w)
}
content += padded
if i < len(lines)-1 {
content += "\n"
}
}
box := pterm.DefaultBox.
WithTitle(pterm.Yellow("Update Available")).
WithBoxStyle(pterm.NewStyle(pterm.FgYellow))
box.Println(content)
}
// SyncSummary prints a beautiful sync summary box
func SyncSummary(stats SyncStats) {
if !IsTTY() {
fmt.Printf("\n─── Sync Complete ───\n")
fmt.Printf(" Targets: %d Linked: %d Local: %d Updated: %d Pruned: %d\n",
stats.Targets, stats.Linked, stats.Local, stats.Updated, stats.Pruned)
if stats.Duration > 0 {
fmt.Printf(" Duration: %.1fs\n", stats.Duration.Seconds())
}
return
}
// Build stats line with colors
statsLine := fmt.Sprintf(
" %s targets %s linked %s local %s updated %s pruned",
pterm.Cyan(fmt.Sprint(stats.Targets)),
pterm.Green(fmt.Sprint(stats.Linked)),
pterm.Blue(fmt.Sprint(stats.Local)),
pterm.Yellow(fmt.Sprint(stats.Updated)),
pterm.Gray(fmt.Sprint(stats.Pruned)),
)
var durationLine string
if stats.Duration > 0 {
durationLine = fmt.Sprintf(" Completed in %s", pterm.Gray(fmt.Sprintf("%.1fs", stats.Duration.Seconds())))
}
// Build content with proper padding
lines := []string{"", statsLine}
if durationLine != "" {
lines = append(lines, durationLine)
}
lines = append(lines, "")
// Find max display width
maxLen := 0
for _, line := range lines {
w := displayWidth(line)
if w > maxLen {
maxLen = w
}
}
// Pad lines
var content strings.Builder
for i, line := range lines {
padded := line
w := displayWidth(line)
if w < maxLen {
padded = line + strings.Repeat(" ", maxLen-w)
}
content.WriteString(padded)
if i < len(lines)-1 {
content.WriteString("\n")
}
}
box := pterm.DefaultBox.
WithTitle(pterm.Green("✓ Sync Complete")).
WithBoxStyle(pterm.NewStyle(pterm.FgGreen))
box.Println(content.String())
}
// SyncStats holds statistics for sync summary
type SyncStats struct {
Targets int
Linked int
Local int
Updated int
Pruned int
Duration time.Duration
}
// ListItem prints a list item with status
func ListItem(status, name, detail string) {
var statusIcon string
var style pterm.Style
switch status {
case "success":
statusIcon = "✓"
style = *pterm.NewStyle(pterm.FgGreen)
case "error":
statusIcon = "✗"
style = *pterm.NewStyle(pterm.FgRed)
case "warning":
statusIcon = "!"
style = *pterm.NewStyle(pterm.FgYellow)
default:
statusIcon = "→"
style = *pterm.NewStyle(pterm.FgCyan)
}
if IsTTY() {
fmt.Printf(" %s %-20s %s\n", style.Sprint(statusIcon), name, pterm.Gray(detail))
} else {
fmt.Printf(" %s %-20s %s\n", statusIcon, name, detail)
}
}
// Step-based UI components for install flow
const (
StepArrow = "▸"
StepCheck = "✓"
StepCross = "✗"
StepBullet = "●"
StepLine = "│"
StepBranch = "├"
StepCorner = "└"
)
// StepStart prints the first step (with arrow)
func StepStart(label, value string) {
if IsTTY() {
fmt.Printf("%s %s %s\n", pterm.Yellow(StepArrow), pterm.White(label), value)
} else {
fmt.Printf("%s %s %s\n", StepArrow, label, value)
}
}
// StepContinue prints a middle step (with branch)
func StepContinue(label, value string) {
if IsTTY() {
fmt.Printf("%s\n", pterm.Gray(StepLine))
fmt.Printf("%s %s %s\n", pterm.Gray(StepBranch+"─"), pterm.White(label), value)
} else {
fmt.Printf("%s\n", StepLine)
fmt.Printf("%s─ %s %s\n", StepBranch, label, value)
}
}
// StepEnd prints the last step (with corner)
func StepEnd(label, value string) {
if IsTTY() {
fmt.Printf("%s\n", pterm.Gray(StepLine))
fmt.Printf("%s %s %s\n", pterm.Gray(StepCorner+"─"), pterm.White(label), value)
} else {
fmt.Printf("%s\n", StepLine)
fmt.Printf("%s─ %s %s\n", StepCorner, label, value)
}
}
// TreeSpinner is a spinner that fits into tree structure
type TreeSpinner struct {
spinner *pterm.SpinnerPrinter
start time.Time
isLast bool
}
// StartTreeSpinner starts a spinner in tree context
func StartTreeSpinner(message string, isLast bool) *TreeSpinner {
prefix := StepBranch + "─"
if isLast {
prefix = StepCorner + "─"
}
if !IsTTY() {
fmt.Printf("%s\n", StepLine)
fmt.Printf("%s %s\n", prefix, message)
return &TreeSpinner{start: time.Now(), isLast: isLast}
}
fmt.Printf("%s\n", pterm.Gray(StepLine))
// Custom spinner with tree prefix
s, _ := pterm.DefaultSpinner.
WithRemoveWhenDone(true).
Start(message)
return &TreeSpinner{spinner: s, start: time.Now(), isLast: isLast}
}
// Success completes the tree spinner with success
func (ts *TreeSpinner) Success(message string) {
elapsed := time.Since(ts.start)
prefix := StepBranch + "─"
if ts.isLast {
prefix = StepCorner + "─"
}
if ts.spinner != nil {
ts.spinner.Stop()
}
if IsTTY() {
fmt.Printf("%s %s %s\n", pterm.Gray(prefix), pterm.Green(message), pterm.Gray(fmt.Sprintf("(%.1fs)", elapsed.Seconds())))
} else {
fmt.Printf("%s %s (%.1fs)\n", prefix, message, elapsed.Seconds())
}
}
// Fail completes the tree spinner with failure
func (ts *TreeSpinner) Fail(message string) {
prefix := StepBranch + "─"
if ts.isLast {
prefix = StepCorner + "─"
}
if ts.spinner != nil {
ts.spinner.Stop()
}
if IsTTY() {
fmt.Printf("%s %s\n", pterm.Gray(prefix), pterm.Red(message))
} else {
fmt.Printf("%s %s\n", prefix, message)
}
}
// StepItem prints a step with label and value (legacy, use StepStart/Continue/End)
func StepItem(label, value string) {
if IsTTY() {
fmt.Printf("%s %-10s %s\n", pterm.Yellow(StepArrow), pterm.White(label), value)
} else {
fmt.Printf("%s %-10s %s\n", StepArrow, label, value)
}
}
// StepDone prints a completed step
func StepDone(label, value string) {
if IsTTY() {
fmt.Printf("%s %-10s %s\n", pterm.Green(StepCheck), pterm.White(label), value)
} else {
fmt.Printf("%s %-10s %s\n", StepCheck, label, value)
}
}
// StepFail prints a failed step
func StepFail(label, value string) {
if IsTTY() {
fmt.Printf("%s %-10s %s\n", pterm.Red(StepCross), pterm.White(label), value)
} else {
fmt.Printf("%s %-10s %s\n", StepCross, label, value)
}
}
// SkillBox prints a skill in a styled box with name and description
func SkillBox(name, description, location string) {
if !IsTTY() {
fmt.Printf("\n── %s ──\n", name)
if description != "" {
fmt.Printf(" %s\n", description)
}
if location != "" {
fmt.Printf(" Location: %s\n", location)
}
return
}
// Build content lines
var lines []string
lines = append(lines, "")
if description != "" {
wrapped := wrapText(description, 55)
for _, line := range wrapped {
lines = append(lines, " "+line)
}
}
if location != "" {
lines = append(lines, "")
lines = append(lines, fmt.Sprintf(" %s %s", pterm.Gray("Location:"), pterm.Gray(location)))
}
lines = append(lines, "")
// Calculate max width
maxLen := 0
for _, line := range lines {
w := displayWidth(line)
if w > maxLen {
maxLen = w
}
}
// Pad lines
var content strings.Builder
for i, line := range lines {
padded := line
w := displayWidth(line)
if w < maxLen {
padded = line + strings.Repeat(" ", maxLen-w)
}
content.WriteString(padded)
if i < len(lines)-1 {
content.WriteString("\n")
}
}
box := pterm.DefaultBox.
WithTitle(pterm.Cyan(name)).
WithTitleTopLeft()
box.Println(content.String())
}
// SkillBoxCompact prints a compact skill box (for multiple skills)
func SkillBoxCompact(name, location string) {
if IsTTY() {
loc := location
if loc == "." {
loc = "root"
}
fmt.Printf(" %s %s %s\n", pterm.Cyan(StepBullet), pterm.White(name), pterm.Gray("("+loc+")"))
} else {
loc := location
if loc == "." {
loc = "root"
}
fmt.Printf(" %s %s (%s)\n", StepBullet, name, loc)
}
}
// SkillDisplay holds skill info for display
type SkillDisplay struct {
Name string
Description string
Path string
}
// wrapText wraps text to specified width
func wrapText(text string, width int) []string {
if len(text) <= width {
return []string{text}
}
var lines []string
words := strings.Fields(text)
currentLine := ""
for _, word := range words {
if currentLine == "" {
currentLine = word
} else if len(currentLine)+1+len(word) <= width {
currentLine += " " + word
} else {
lines = append(lines, currentLine)
currentLine = word
}
}
if currentLine != "" {
lines = append(lines, currentLine)
}
return lines
}