/**
* π¨ CLI Display utilities
* Making the terminal beautiful since 2026
*/
import chalk from "chalk";
import boxen from "boxen";
import figlet from "figlet";
import gradient from "gradient-string";
import { createSpinner } from "nanospinner";
import { getConfig } from "../../utils/config.js";
import { getRandomMessage, type MessageType } from "./messages.js";
import type { PullRequestInfo, RepoInfo } from "../../types/index.js";
// Custom gradients
const seanGradient = gradient(["#FF6B6B", "#4ECDC4", "#45B7D1"]);
const successGradient = gradient(["#56ab2f", "#a8e063"]);
const errorGradient = gradient(["#ED213A", "#93291E"]);
const infoGradient = gradient(["#2193b0", "#6dd5ed"]);
/**
* Display the epic banner
*/
export function showBanner(): void {
const config = getConfig();
console.log();
console.log(
seanGradient(
figlet.textSync("AZUCAR", {
font: "ANSI Shadow",
horizontalLayout: "fitted",
}),
),
);
console.log(
chalk.gray(" βββββββββββββββββββββββββββββββββββββββββββββββββββββ"),
);
console.log(
chalk.cyan(" π¬ PR Automation β’ Code Reviews β’ JIRA Integration"),
);
console.log(
chalk.gray(" βββββββββββββββββββββββββββββββββββββββββββββββββββββ"),
);
console.log();
// Random welcome message based on personality
console.log(
chalk.yellow(getRandomMessage("welcome", config.cli.personality)),
);
console.log();
}
/**
* Show a styled message box
*/
export function showBox(
content: string,
options?: {
title?: string;
borderColor?: string;
padding?: number;
},
): void {
console.log(
boxen(content, {
padding: options?.padding ?? 1,
margin: 1,
borderStyle: "round",
borderColor: options?.borderColor || "cyan",
title: options?.title,
titleAlignment: "center",
}),
);
}
/**
* Show success message
*/
export function showSuccess(message: string): void {
const config = getConfig();
console.log();
console.log(successGradient(" β
SUCCESS"));
console.log(chalk.green(` ${message}`));
console.log();
console.log(
chalk.gray(` ${getRandomMessage("success", config.cli.personality)}`),
);
console.log();
}
/**
* Show error message
*/
export function showError(message: string, details?: string): void {
const config = getConfig();
console.log();
console.log(errorGradient(" β ERROR"));
console.log(chalk.red(` ${message}`));
if (details) {
console.log(chalk.gray(` ${details}`));
}
console.log();
console.log(
chalk.gray(` ${getRandomMessage("error", config.cli.personality)}`),
);
console.log();
}
/**
* Show warning message
*/
export function showWarning(message: string): void {
console.log();
console.log(chalk.yellow(" β οΈ WARNING"));
console.log(chalk.yellow(` ${message}`));
console.log();
}
/**
* Show info message
*/
export function showInfo(message: string): void {
console.log();
console.log(infoGradient(" βΉοΈ INFO"));
console.log(chalk.cyan(` ${message}`));
console.log();
}
/**
* Create a spinner with personality
*/
export function createStyledSpinner(text: string) {
const config = getConfig();
const spinnerText = `${text} ${chalk.gray(getRandomMessage("thinking", config.cli.personality))}`;
return createSpinner(spinnerText, {
color: "cyan",
frames: ["β ", "β ", "β Ή", "β Έ", "β Ό", "β ΄", "β ¦", "β §", "β ", "β "],
});
}
/**
* Display PR info in a nice format
*/
export function displayPRInfo(pr: PullRequestInfo): void {
const statusColor =
pr.state === "open"
? pr.draft
? chalk.gray
: chalk.green
: pr.state === "closed"
? chalk.red
: chalk.magenta;
const statusText = pr.draft ? "DRAFT" : pr.state.toUpperCase();
const content = [
`${chalk.bold("Title:")} ${pr.title}`,
`${chalk.bold("Number:")} #${pr.number}`,
`${chalk.bold("Status:")} ${statusColor(statusText)}`,
`${chalk.bold("Branch:")} ${chalk.cyan(pr.head.ref)} β ${chalk.cyan(pr.base.ref)}`,
`${chalk.bold("Author:")} ${pr.user?.login || "Unknown"}`,
"",
`${chalk.bold("Changes:")} ${chalk.green(`+${pr.additions}`)} ${chalk.red(`-${pr.deletions}`)} in ${pr.changed_files} files`,
"",
`${chalk.bold("URL:")} ${chalk.underline.blue(pr.html_url)}`,
].join("\n");
showBox(content, {
title: "π Pull Request",
borderColor: pr.draft ? "gray" : "green",
});
}
/**
* Display a list of PRs
*/
export function displayPRList(prs: PullRequestInfo[]): void {
if (prs.length === 0) {
showInfo("No pull requests found.");
return;
}
console.log();
console.log(chalk.bold.cyan(" π Pull Requests"));
console.log(chalk.gray(" βββββββββββββββββββββββββββββββββββββββββ"));
prs.forEach((pr, index) => {
const statusIcon = pr.draft ? "π" : pr.state === "open" ? "π’" : "π΄";
const number = chalk.gray(`#${pr.number}`);
const title = chalk.white(
pr.title.slice(0, 50) + (pr.title.length > 50 ? "..." : ""),
);
const branch = chalk.cyan(pr.head.ref);
console.log(` ${statusIcon} ${number} ${title}`);
console.log(` ${chalk.gray("β³")} ${branch} β ${pr.base.ref}`);
if (index < prs.length - 1) {
console.log();
}
});
console.log(chalk.gray(" βββββββββββββββββββββββββββββββββββββββββ"));
console.log();
}
/**
* Show goodbye message
*/
export function showGoodbye(): void {
const config = getConfig();
console.log();
console.log(chalk.gray("βββββββββββββββββββββββββββββββββββββββββ"));
console.log(
seanGradient(getRandomMessage("goodbye", config.cli.personality)),
);
console.log(chalk.gray("βββββββββββββββββββββββββββββββββββββββββ"));
console.log();
}
/**
* Show configuration status
*/
export function showConfigStatus(configured: boolean, username?: string): void {
if (configured && username) {
showBox(
`${chalk.green("β")} Connected to GitHub as ${chalk.bold.cyan(username)}`,
{ title: "π Configuration", borderColor: "green" },
);
} else {
showBox(
[
`${chalk.red("β")} GitHub not configured`,
"",
`${chalk.yellow("To set up:")}`,
` 1. Copy ${chalk.cyan(".env.example")} to ${chalk.cyan(".env")}`,
` 2. Add your GitHub token`,
` 3. Set your GitHub username`,
].join("\n"),
{ title: "π Configuration Required", borderColor: "red" },
);
}
}
/**
* Display divider
*/
export function divider(): void {
console.log(
chalk.gray(" βββββββββββββββββββββββββββββββββββββββββββββββββ"),
);
}
/**
* Message with personality
*/
export function say(type: MessageType): void {
const config = getConfig();
console.log(
chalk.gray(` ${getRandomMessage(type, config.cli.personality)}`),
);
}
/**
* Display repository info in a nice format
*/
export function displayRepoInfo(repo: RepoInfo): void {
const visibilityIcon = repo.private ? "π" : "π";
const visibilityText = repo.private
? chalk.yellow("Private")
: chalk.green("Public");
const content = [
`${chalk.bold("Name:")} ${repo.name}`,
`${chalk.bold("Full Name:")} ${repo.full_name}`,
`${chalk.bold("Visibility:")} ${visibilityIcon} ${visibilityText}`,
repo.description ? `${chalk.bold("Description:")} ${repo.description}` : "",
"",
`${chalk.bold("Default Branch:")} ${chalk.cyan(repo.default_branch)}`,
`${chalk.bold("Stats:")} β ${repo.stargazers_count} π΄ ${repo.forks_count} π ${repo.open_issues_count} issues`,
"",
`${chalk.bold("Clone (SSH):")} ${chalk.cyan(repo.ssh_url)}`,
`${chalk.bold("Clone (HTTPS):")} ${chalk.cyan(repo.clone_url)}`,
"",
`${chalk.bold("URL:")} ${chalk.underline.blue(repo.html_url)}`,
]
.filter(Boolean)
.join("\n");
showBox(content, {
title: "π¦ Repository",
borderColor: repo.private ? "yellow" : "green",
});
}
/**
* Display issue status for a repo
*/
export function displayIssueStatus(
repo: RepoInfo,
issueStatus: { enabled: boolean; open_count: number; closed_count?: number },
): void {
const statusIcon = issueStatus.enabled ? "β
" : "π«";
const statusText = issueStatus.enabled
? chalk.green("Enabled")
: chalk.red("Disabled");
const content = [
`${chalk.bold("Repository:")} ${repo.full_name}`,
"",
`${chalk.bold("Issues:")} ${statusIcon} ${statusText}`,
];
if (issueStatus.enabled) {
content.push(
"",
`${chalk.bold("Open Issues:")} ${chalk.yellow(issueStatus.open_count.toString())}`,
);
}
showBox(content.join("\n"), {
title: "π Issue Status",
borderColor: issueStatus.enabled ? "green" : "red",
});
}
