@agentuity/cli 0.0.69 → 0.0.71

package/src/tui/box.ts

@@ -0,0 +1,202 @@
+/**
+ * Box and note rendering utilities for TUI
+ */
+import { symbols } from './symbols';
+import { colors } from './colors';
+
+/**
+ * Get terminal width
+ */
+function getTerminalWidth(): number {
+	return process.stdout.columns || 80;
+}
+
+/**
+ * Get string width (accounting for ANSI codes)
+ */
+function stringWidth(str: string): number {
+	// Remove ANSI escape codes
+	// eslint-disable-next-line no-control-regex
+	const cleaned = str.replace(/\x1b\[[0-9;]*m/g, '');
+	return cleaned.length;
+}
+
+/**
+ * Wrap text to fit within width
+ */
+function wrapText(text: string, width: number): string[] {
+	const words = text.split(' ');
+	const lines: string[] = [];
+	let currentLine = '';
+
+	for (const word of words) {
+		// Handle words longer than width
+		if (stringWidth(word) > width) {
+			if (currentLine) lines.push(currentLine);
+			// Truncate long words with ellipsis if width allows, otherwise just slice
+			if (width >= 4) {
+				lines.push(word.slice(0, width - 3) + '...');
+			} else {
+				lines.push(word.slice(0, Math.max(0, width)));
+			}
+			currentLine = '';
+			continue;
+		}
+
+		const testLine = currentLine ? `${currentLine} ${word}` : word;
+		if (stringWidth(testLine) <= width) {
+			currentLine = testLine;
+		} else {
+			if (currentLine) lines.push(currentLine);
+			currentLine = word;
+		}
+	}
+	if (currentLine) lines.push(currentLine);
+
+	return lines;
+}
+
+interface BoxOptions {
+	title?: string;
+	content: string;
+	titleAlign?: 'left' | 'center' | 'right';
+	contentAlign?: 'left' | 'center' | 'right';
+	width?: number;
+	padding?: number;
+	withGuide?: boolean;
+}
+
+/**
+ * Draw a boxed message (like clack's note)
+ */
+export function drawBox(options: BoxOptions): string {
+	const {
+		title = '',
+		content,
+		titleAlign = 'left',
+		contentAlign = 'left',
+		withGuide = true,
+	} = options;
+
+	const termWidth = getTerminalWidth();
+
+	// Calculate box width (no guide prefix inside the box)
+	const maxWidth = termWidth - 3; // Account for guide prefix space
+	const boxWidth = options.width || Math.min(60, maxWidth);
+	// Ensure we never end up with negative inner/content widths
+	const innerWidth = Math.max(boxWidth - 2, 1); // Subtract left/right borders safely
+
+	// Clamp padding to non-negative
+	const padding = Math.max(0, options.padding ?? 2);
+
+	// Prepare title line
+	// Title format: ◇  [title] ───────╮
+	// The title line should match the width of content lines: │[innerWidth]│
+	let titleLine = '';
+
+	if (title) {
+		const symbol = `${colors.success(symbols.completed)}`;
+		const titleText = colors.reset(title);
+		const titleTextWidth = stringWidth(symbols.completed) + stringWidth(title);
+		const barsNeeded = Math.max(innerWidth - titleTextWidth - 3, 1); // -3 for symbol, 2 spaces, and 1 space before bars
+
+		// Apply title alignment
+		if (titleAlign === 'center') {
+			const leftBars = Math.floor(barsNeeded / 2);
+			const rightBars = barsNeeded - leftBars;
+			titleLine = `${colors.secondary(symbols.barH.repeat(leftBars))} ${symbol}  ${titleText} ${colors.secondary(symbols.barH.repeat(rightBars) + symbols.cornerTR)}`;
+		} else if (titleAlign === 'right') {
+			titleLine = `${colors.secondary(symbols.barH.repeat(barsNeeded))} ${symbol}  ${titleText} ${colors.secondary(symbols.cornerTR)}`;
+		} else {
+			// left (default)
+			titleLine = `${symbol}  ${titleText} ${colors.secondary(symbols.barH.repeat(barsNeeded) + symbols.cornerTR)}`;
+		}
+	}
+
+	// Prepare content lines
+	const contentLines = content.split('\n');
+	const wrappedLines: string[] = [];
+
+	// Ensure content width is non-negative
+	const wrapWidth = Math.max(innerWidth - padding * 2, 0);
+
+	for (const line of contentLines) {
+		if (stringWidth(line) > wrapWidth) {
+			wrappedLines.push(...wrapText(line, wrapWidth));
+		} else {
+			wrappedLines.push(line);
+		}
+	}
+
+	// Build box (without guide prefix on each line)
+	const boxLines: string[] = [];
+
+	// Title line
+	if (title) {
+		boxLines.push(titleLine);
+	}
+
+	// Content lines with borders
+	// The title line is innerWidth + 1 wide, so content should be innerWidth - 1 between bars
+	const contentWidth = Math.max(innerWidth - 1, 0);
+	const emptyLine = `${colors.secondary(symbols.bar)}${' '.repeat(contentWidth)}${colors.secondary(symbols.bar)}`;
+	boxLines.push(emptyLine);
+
+	for (const line of wrappedLines) {
+		const lineLen = stringWidth(line);
+		let leftPad =
+			contentAlign === 'right'
+				? contentWidth - lineLen - padding
+				: contentAlign === 'center'
+					? Math.floor((contentWidth - lineLen) / 2)
+					: padding;
+
+		// Clamp to non-negative
+		leftPad = Math.max(leftPad, 0);
+		const rightPad = Math.max(contentWidth - lineLen - leftPad, 0);
+
+		boxLines.push(
+			`${colors.secondary(symbols.bar)}${' '.repeat(leftPad)}${line}${' '.repeat(rightPad)}${colors.secondary(symbols.bar)}`
+		);
+	}
+
+	boxLines.push(emptyLine);
+
+	// Now add guide bar before/after if needed
+	const lines: string[] = [];
+
+	if (withGuide) {
+		lines.push(colors.secondary(symbols.bar));
+	}
+
+	// Add all box lines (no prefix - flush left)
+	lines.push(...boxLines);
+
+	// Bottom border - should match content line width (│ + contentWidth + │)
+	// contentWidth = innerWidth - 1, so total is innerWidth + 1
+	// Bottom border: ├ + (innerWidth - 1) bars + ╯ = innerWidth + 1
+	if (withGuide) {
+		lines.push(
+			colors.secondary(symbols.connect + symbols.barH.repeat(innerWidth - 1) + symbols.cornerBR)
+		);
+	} else {
+		lines.push(
+			colors.secondary(symbols.cornerBL + symbols.barH.repeat(innerWidth - 1) + symbols.cornerBR)
+		);
+	}
+
+	return lines.join('\n');
+}
+
+/**
+ * Render a note box (matches clack style)
+ */
+export function note(message: string, title = ''): void {
+	const output = drawBox({
+		title,
+		content: message,
+		contentAlign: 'left',
+		withGuide: true,
+	});
+	console.log(output);
+}

package/src/tui/colors.ts

@@ -0,0 +1,55 @@
+/**
+ * Color utilities for TUI components using existing tui.ts color system
+ */
+
+// ANSI escape codes for additional colors not in main tui.ts
+const RESET = '\x1b[0m';
+const CYAN = '\x1b[36m';
+const GRAY = '\x1b[90m';
+const RED = '\x1b[31m';
+const YELLOW = '\x1b[33m';
+const GREEN = '\x1b[32m';
+const BLUE = '\x1b[34m';
+const DIM = '\x1b[2m';
+const BOLD = '\x1b[1m';
+const UNDERLINE = '\x1b[4m';
+const BG_CYAN = '\x1b[46m';
+const BLACK = '\x1b[30m';
+const WHITE = '\x1b[37m';
+
+/**
+ * Detect if terminal is in dark mode
+ */
+function isDarkMode(): boolean {
+	const scheme = process.env.COLOR_SCHEME;
+	if (scheme === 'light') return false;
+	if (scheme === 'dark') return true;
+	return true;
+}
+
+export const colors = {
+	// State colors - using simple ANSI codes (consistent with tui.ts approach)
+	active: (text: string) => `${CYAN}${text}${RESET}`,
+	completed: (text: string) => `${GRAY}${text}${RESET}`,
+	error: (text: string) => `${RED}${text}${RESET}`,
+	warning: (text: string) => `${YELLOW}${text}${RESET}`,
+	success: (text: string) => `${GREEN}${text}${RESET}`,
+	info: (text: string) => `${BLUE}${text}${RESET}`,
+
+	// Text formatting
+	muted: (text: string) => `${DIM}${text}${RESET}`,
+	bold: (text: string) => `${BOLD}${text}${RESET}`,
+	underline: (text: string) => `${UNDERLINE}${text}${RESET}`,
+	reset: (text: string) => `${RESET}${text}`,
+
+	// Semantic colors
+	primary: (text: string) => `${CYAN}${text}${RESET}`,
+	secondary: (text: string) => `${GRAY}${text}${RESET}`,
+	link: (text: string) => `${CYAN}${UNDERLINE}${text}${RESET}`,
+
+	// Inversed colors (adapt to light/dark mode)
+	inverseCyan: (text: string) => {
+		const dark = isDarkMode();
+		return dark ? `${BG_CYAN}${BLACK}${text}${RESET}` : `${BG_CYAN}${WHITE}${text}${RESET}`;
+	},
+};

package/src/tui/group.ts

@@ -0,0 +1,56 @@
+/**
+ * Grouped prompts orchestration
+ */
+
+type Prettify<T> = {
+	[P in keyof T]: T[P];
+} & {};
+
+export type PromptGroupAwaitedReturn<T> = {
+	[P in keyof T]: Exclude<Awaited<T[P]>, symbol>;
+};
+
+export type PromptGroup<T> = {
+	[P in keyof T]: (opts: {
+		results: Prettify<Partial<PromptGroupAwaitedReturn<Omit<T, P>>>>;
+	}) => undefined | Promise<T[P] | undefined>;
+};
+
+export interface PromptGroupOptions<T> {
+	onCancel?: (opts: { results: Prettify<Partial<PromptGroupAwaitedReturn<T>>> }) => void;
+}
+
+/**
+ * Execute a group of prompts sequentially
+ */
+export async function group<T>(
+	prompts: PromptGroup<T>,
+	opts?: PromptGroupOptions<T>
+): Promise<Prettify<PromptGroupAwaitedReturn<T>>> {
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any
+	const results: any = {};
+	const promptNames = Object.keys(prompts);
+
+	for (const name of promptNames) {
+		const prompt = prompts[name as keyof T];
+		try {
+			const result = await prompt({ results });
+
+			// Skip if undefined (conditional prompt)
+			if (result === undefined) {
+				continue;
+			}
+
+			results[name] = result;
+		} catch (error) {
+			// Handle cancellation
+			if (opts?.onCancel) {
+				results[name] = 'canceled';
+				opts.onCancel({ results });
+			}
+			throw error;
+		}
+	}
+
+	return results as Prettify<PromptGroupAwaitedReturn<T>>;
+}